Update organizations-related GetAllForUser method docs to make it c…

…lear that only public memberships are returned

Fixes #2470.

Octokit/Clients/IOrganizationsClient.cs

@@ -65,19 +65,27 @@ public interface IOrganizationsClient
  Task<IReadOnlyList<Organization>> GetAllForCurrent(ApiOptions options);
 
  /// <summary>
- /// Returns all <see cref="Organization" />s for the specified user.
+ /// Returns <see cref="Organization" />s which the specified user is a member of,
+ /// where the user hasn't marked their membership as private.
  /// </summary>
  /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
- /// <returns>A list of the specified user's <see cref="Organization"/>s.</returns>
+ /// <returns>
+ /// A list of the <see cref="Organization"/>s which the specified user is a member
+ /// of, where they haven't marked their membership as private
+ /// </returns>
  Task<IReadOnlyList<Organization>> GetAllForUser(string user);
 
  /// <summary>
- /// Returns all <see cref="Organization" />s for the specified user.
+ /// Returns <see cref="Organization" />s which the specified user is a member of,
+ /// where the user hasn't marked their membership as private.
  /// </summary>
  /// <param name="user">The login of the user</param>
  /// <param name="options">Options for changing the API response</param>
  /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
- /// <returns>A list of the specified user's <see cref="Organization"/>s.</returns>
+ /// <returns>
+ /// A list of the <see cref="Organization"/>s which the specified user is a member
+ /// of, where they haven't marked their membership as private
+ /// </returns>
  Task<IReadOnlyList<Organization>> GetAllForUser(string user, ApiOptions options);
 
  /// <summary>

Octokit/Clients/OrganizationsClient.cs

@@ -85,11 +85,15 @@ public Task<IReadOnlyList<Organization>> GetAllForCurrent(ApiOptions options)
  }
 
  /// <summary>
- /// Returns all <see cref="Organization" />s for the specified user.
+ /// Returns <see cref="Organization" />s which the specified user is a member of,
+ /// where the user hasn't marked their membership as private.
  /// </summary>
  /// <param name="user">The login of the user</param>
  /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
- /// <returns>A list of the specified user's <see cref="Organization"/>s.</returns>
+ /// <returns>
+ /// A list of the <see cref="Organization"/>s which the specified user is a member
+ /// of, where they haven't marked their membership as private
+ /// </returns>
  [ManualRoute("GET", "/users/{username}/orgs")]
  public Task<IReadOnlyList<Organization>> GetAllForUser(string user)
  {
@@ -99,12 +103,16 @@ public Task<IReadOnlyList<Organization>> GetAllForUser(string user)
  }
 
  /// <summary>
- /// Returns all <see cref="Organization" />s for the specified user.
+ /// Returns <see cref="Organization" />s which the specified user is a member of,
+ /// where the user hasn't marked their membership as private.
  /// </summary>
  /// <param name="user">The login of the user</param>
  /// <param name="options">Options for changing the API response</param>
  /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
- /// <returns>A list of the specified user's <see cref="Organization"/>s.</returns>
+ /// <returns>
+ /// A list of the <see cref="Organization"/>s which the specified user is a member
+ /// of, where they haven't marked their membership as private
+ /// </returns>
  [ManualRoute("GET", "/users/{username}/orgs")]
  public Task<IReadOnlyList<Organization>> GetAllForUser(string user, ApiOptions options)
  {