start using PATCH in favor of PUT

technoweenie · technoweenie · commit 799ddfbcb44c · 2011-04-27T09:04:25.000-04:00
diff --git a/content/v3.md b/content/v3.md
@@ -38,6 +38,34 @@ All timestamps are returned in ISO 8601 format:
 
     YYYY-MM-DDTHH:MM:SSZ
 
+## HTTP Verbs
+
+Where possible, API v3 strives to use appropriate HTTP verbs for each
+action.
+
+HEAD
+: Can be issued against any resource to get just the HTTP header info.
+
+GET
+: Used for retrieving resources.
+
+POST
+: Used for creating resources, or performing custom actions (such as
+merging a pull request).
+
+PATCH
+: Used for updating resources with partial JSON data.  For instance, an
+Issue resource has `title` and `body` attributes.  A PATCH request will
+accept just one of the attributes to update the resource.  PATCH is a
+relatively new and uncommon HTTP verb, so resource endpoints also accept
+POST requests.
+
+PUT
+: Used for replacing resources or collections.
+
+DELETE
+: Used for deleting resources.
+
 ## Authentication
 
 There are two ways to authenticate through GitHub API v3:
diff --git a/content/v3/gists.md b/content/v3/gists.md
@@ -200,7 +200,7 @@ including information about data format and authentication.
 
 ## Edit a gist
 
-    PUT /gists/:id.json
+    PATCH /gists/:id.json
 
 <pre class="highlight"><code class="language-javascript">
 {
diff --git a/content/v3/gists/comments.md b/content/v3/gists/comments.md
@@ -89,7 +89,7 @@ title: Gist Comments API v3 | dev.github.com
 
 ## Edit
 
-    PUT /gists/comments/:id.json
+    PATCH /gists/comments/:id.json
 
 ### Response
 
diff --git a/content/v3/issues.md b/content/v3/issues.md
@@ -53,7 +53,7 @@ labels
 
 ## Edit an Issue
 
-    PUT /repos/:user/:repo/issues/:id.json
+    PATCH /repos/:user/:repo/issues/:id.json
 
 ### Input
 
diff --git a/content/v3/issues/labels.md b/content/v3/issues/labels.md
@@ -27,7 +27,7 @@ title: Issue Labels API v3 | dev.github.com
 
 ## Update a Label
 
-    PUT /repos/:user/:repo/labels/:id.json
+    PATCH /repos/:user/:repo/labels/:id.json
 
 ### Input
 
diff --git a/content/v3/issues/milestones.md b/content/v3/issues/milestones.md
@@ -38,7 +38,7 @@ state
 
 ## Update a Milestone
 
-    PUT /repos/:user/:repo/milestones/:id.json
+    PATCH /repos/:user/:repo/milestones/:id.json
 
 ### Input
 

Original file line number	Diff line number	Diff line change
`@@ -200,7 +200,7 @@ including information about data format and authentication.`
`200`	`200`
`201`	`201`	`## Edit a gist`
`202`	`202`
`203`		`- PUT /gists/:id.json`
	`203`	`+ PATCH /gists/:id.json`
`204`	`204`
`205`	`205`	`<pre class="highlight"><code class="language-javascript">`
`206`	`206`	`{`