docs(users): add docs about listing a user's projects

JohnVillalovos · JohnVillalovos · commit 7b32fc44661e · 2022-07-04T12:42:14.000-07:00
Add docs about listing a user's projects.

Update docs on the membership API to update the URL to the upstream
docs and also add a note that it requires Administrator access to use.
diff --git a/docs/gl_objects/users.rst b/docs/gl_objects/users.rst
@@ -192,6 +192,31 @@ Revoke (delete) an impersonation token for a user::
     i_t.delete()
 
 
+User projects
+=========================
+
+References
+----------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.UserProject`
+  + :class:`gitlab.v4.objects.UserProjectManager`
+  + :attr:`gitlab.v4.objects.User.projects`
+
+* GitLab API: https://docs.gitlab.com/ee/api/projects.html#list-user-projects
+
+List visible projects owned by the user::
+
+    projects = user.projects.list()
+
+.. note::
+
+    Only the projects in the user’s namespace are returned. Projects owned by
+    the user in any group or subgroups are not returned. An empty list is
+    returned if a profile is set to private.
+
+
 User memberships
 =========================
 
@@ -204,7 +229,7 @@ References
   + :class:`gitlab.v4.objects.UserMembershipManager`
   + :attr:`gitlab.v4.objects.User.memberships`
 
-* GitLab API: https://docs.gitlab.com/ee/api/users.html#user-memberships-admin-only
+* GitLab API: https://docs.gitlab.com/ee/api/users.html#user-memberships
 
 List direct memberships for a user::
 
@@ -218,6 +243,10 @@ List only direct group memberships::
 
     memberships = user.memberships.list(type='Namespace')
 
+.. note::
+
+    Administrator access is required.
+
 Current User
 ============
 
