Merge branch 'patch-196' into 'master'

Document bug with emails endpoint missing primary

See merge request gitlab-org/gitlab!37271

doc/api/users.md

@@ -1053,6 +1053,10 @@ curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://git
 
 Get a list of currently authenticated user's emails.
 
+NOTE: **Note:**
+Due to [a bug](https://gitlab.com/gitlab-org/gitlab/-/issues/25077) this endpoint currently
+does not return the primary email address.
+
 ```plaintext
 GET /user/emails
 ```
@@ -1078,6 +1082,10 @@ Parameters:
 
 Get a list of a specified user's emails. Available only for admin
 
+NOTE: **Note:**
+Due to [a bug](https://gitlab.com/gitlab-org/gitlab/-/issues/25077) this endpoint currently
+does not return the primary email address.
+
 ```plaintext
 GET /users/:id/emails
 ```