document repository deletions

technoweenie · technoweenie · commit 9314e032dc89 · 2012-06-13T08:49:55.000-06:00
diff --git a/content/v3.md b/content/v3.md
@@ -8,8 +8,6 @@ This describes the resources that make up the official GitHub API v3. If
 you have any problems or requests please contact
 [support](mailto:support@github.com?subject=APIv3).
 
-**Note:** This API is in a beta state. Breaking changes may occur.
-
 * <a href="#schema">Schema</a>
 * <a href="#client-errors">Client Errors</a>
 * <a href="#http-verbs">HTTP Verbs</a>
diff --git a/content/v3/oauth.md b/content/v3/oauth.md
@@ -126,6 +126,9 @@ public\_repo
 repo
 : Read/write access to public and private repos and organizations.
 
+delete\_repo
+: Delete access to adminable repositories.
+
 gist
 : write access to gists.
 
diff --git a/content/v3/orgs/teams.md b/content/v3/orgs/teams.md
@@ -117,11 +117,11 @@ must be a member of the team.
 
     GET /teams/:id/members/:user
 
-### Reponse if user is a member
+### Response if user is a member
 
 <%= headers 204 %>
 
-### Reponse if user is not a member
+### Response if user is not a member
 
 <%= headers 404 %>
 
@@ -133,7 +133,7 @@ is associated with.
 
     PUT /teams/:id/members/:user
 
-### Reponse
+### Response
 
 <%= headers 204 %>
 
@@ -157,7 +157,7 @@ NOTE: This does not delete the user, it just remove them from the team.
 
     DELETE /teams/:id/members/:user
 
-### Reponse
+### Response
 
 <%= headers 204 %>
 
@@ -174,11 +174,11 @@ NOTE: This does not delete the user, it just remove them from the team.
 
     GET /teams/:id/repos/:user/:repo
 
-### Reponse if repo is managed by this team
+### Response if repo is managed by this team
 
 <%= headers 204 %>
 
-### Reponse if repo is not managed by this team
+### Response if repo is not managed by this team
 
 <%= headers 404 %>
 
@@ -191,7 +191,7 @@ organization.
 
     PUT /teams/:id/repos/:user/:repo
 
-### Reponse
+### Response
 
 <%= headers 204 %>
 
@@ -215,7 +215,7 @@ NOTE: This does not delete the repo, it just removes it from the team.
 
     DELETE /teams/:id/repos/:user/:repo
 
-### Reponse
+### Response
 
 <%= headers 204 %>
 
diff --git a/content/v3/repos.md b/content/v3/repos.md
@@ -217,3 +217,15 @@ in results.
 
 <%= headers 200 %>
 <%= json(:branch) { |h| [h] }%>
+
+## Delete a Repository
+
+Deleting a repository requires admin access.  If OAuth is used, the
+`delete_repo` scope is required.
+
+    DELETE /repos/:user/:repo
+
+### Response
+
+<%= headers 204 %>
+
