Updated members page and added a changes entry to reflect github/github#6584

Peter Williams · Peter Williams · commit de55dd9809a1 · 2012-10-13T17:05:18.000-06:00
diff --git a/content/changes/2012-10-12-org-members-redirection.md b/content/changes/2012-10-12-org-members-redirection.md
@@ -0,0 +1,10 @@
+---
+kind: change
+title: Organization Members Resource Changes
+created_at: 2012-10-12
+author_name: pezra
+---
+
+Requesting the [member list](/v3/orgs/members/index.html#members-list) of an organization of which you are not a member now redirects to the [public members list](v3/orgs/members/index.html#public-members-list). Requests to [membership check](/v3/orgs/members/index.html#check-membership) resources of an organization of which you are not a member are similarly redirected to the equivalent [public membership check](/v3/orgs/members/index.html#check-public-membership) unless it is a check about yourself, in which case it is treated as a request by a member.
+
+The changes where made to clarify the purpose of these various resources. The `/orgs/{org}/members` resources are intended for use by members of the organization in question. The `/orgs/{org}/public_members` resources are intended for acquiring information about organizations of which you are not a member.
diff --git a/content/v3/orgs/members.md b/content/v3/orgs/members.md
@@ -7,12 +7,10 @@ title: Organization Members | GitHub API
 * TOC
 {:toc}
 
-## List members
+## Members list
 
 List all users who are members of an organization. A member is a user
-that belongs to at least 1 team in the organization. If the authenticated user is
-also a member of this organization then both concealed and public
-members will be returned. Otherwise only public members are returned.
+that belongs to at least 1 team in the organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned. If the reqeuster is not a member of the organization the query will be redirected to the [public members list](#public-members-list).
 
     GET /orgs/:org/members
 
@@ -21,25 +19,29 @@ members will be returned. Otherwise only public members are returned.
 <%= headers 200 %>
 <%= json(:user) { |h| [h] } %>
 
-### Response if requester is not a organization member
+### Response if requester is not an organization member
 
 <%= headers 302, "Location" => "https://api.github.com/orgs/github/public_members" %>
 
-## Get member
+## Check membership
 
 Check if a user is, publicly or privately, a member of the organization.
 
     GET /orgs/:org/members/:user
 
-### Response if user is a member
+### Response if requester is an organization member and user is a member
 
 <%= headers 204 %>
 
-### Response if user is not a member
+### Response if requester is an organization member and user is not a member
 
 <%= headers 404 %>
 
-### Response if requester is not a organization member
+### Response if requester is not an organization member and is inquiring about themselves
+
+<%= headers 404 %>
+
+### Response if requester is not an organization member
 
 <%= headers 302, :Location => "https://api.github.com/orgs/github/public_members/pezra" %>
 
@@ -59,7 +61,7 @@ they will no longer have any access to the organization's repositories.
 
 <%= headers 204 %>
 
-## List public members
+## Public members list
 
 Members of an organization can choose to have their membership
 publicized or not.
@@ -71,7 +73,7 @@ publicized or not.
 <%= headers 200 %>
 <%= json(:user) { |h| [h] } %>
 
-## Get if a user is a public member
+## Check public membership
 
     GET /orgs/:org/public_members/:user
 
