docs: enhance release docs for CI_JOB_TOKEN usage

MRigal · MRigal · commit 5d973de8a5ed · 2022-01-21T19:00:50.000+01:00
diff --git a/docs/gl_objects/releases.rst b/docs/gl_objects/releases.rst
@@ -21,6 +21,7 @@ Examples
 
 Get a list of releases from a project::
 
+    project = gl.projects.get(project_id, lazy=True)
     release = project.releases.list()
 
 Get a single release::
@@ -45,6 +46,14 @@ Delete a release::
     # delete object directly
     release.delete()
 
+.. note::
+
+    The Releases API is one of the few working with ``CI_JOB_TOKEN``, but the project can't
+    be fetched with the token. Thus use `lazy` for the project as in the above example.
+
+    Also be aware that most of the capabilities of the endpoint were not accessible with
+    ``CI_JOB_TOKEN`` until Gitlab version 14.5.
+
 Project release links
 =====================
 
