Sync changes from upstream repository

Hubot · Hubot · commit 5122d02fa070 · 2014-07-09T17:34:02.000Z
diff --git a/content/changes/2014-07-09-status-contexts-are-official.md b/content/changes/2014-07-09-status-contexts-are-official.md
@@ -0,0 +1,37 @@
+---
+kind: change
+title: The combined status API is official
+created_at: 2014-07-09
+author_name: bhuga
+---
+
+We're happy to announce that the [Combined Status API][docs] is officially part
+of the GitHub API v3. We now consider it stable for production use.
+
+Thanks to everyone who provided feedback during the comment period. We got
+some great feedback, and hope this feature helps you build the tools you
+need to make GitHub the best place to ship exactly the way you want.
+
+### Preview media type no longer needed
+
+If you used the Combined Status API during the preview period, you needed to
+provide a custom media type in the `Accept` header:
+
+    application/vnd.github.she-hulk-preview+json
+
+Now that the preview period has ended, you no longer need to pass this custom
+media type.
+
+Instead, we [recommend][media-types] that you specify `v3` as the version in the
+`Accept` header:
+
+    application/vnd.github.v3+json
+
+### Feedback
+
+We'll never be done listening to you! As always, please don't hestitate to
+[share your feedback][feedback].
+
+[docs]: /v3/repos/statuses/#get-the-combined-status-for-a-specific-ref
+[media-types]: /v3/media
+[feedback]: https://github.com/contact?form[subject]=Combined+Status+API
diff --git a/content/v3/repos/statuses.md b/content/v3/repos/statuses.md
@@ -56,19 +56,16 @@ Name | Type | Description
 'https://api.github.com/repos/octocat/example/statuses/1' %>
 <%= json :status %>
 
-<% combined_media_type = "application/vnd.github.she-hulk-preview+json" %>
-
 ## List Statuses for a specific Ref
 
 Users with pull access can view commit statuses for a given ref:
 
-    GET /repos/:owner/:repo/statuses/:ref
+    GET /repos/:owner/:repo/commits/:ref/statuses
 
 <div class="alert">
   <p>
-    If you send an <code>Accept</code> header with the Combined Status API preview
-    <a href="/v3/media/">media type</a>, <code><%= combined_media_type %></code>,
-    this endpoint is also available at <code>/repos/:owner/:repo/commits/:ref/statuses</code>.
+    This resource is also available via a legacy route:
+    <code>GET /repos/:owner/:repo/statuses/:ref</code>.
   </p>
 </div>
 
@@ -89,19 +86,6 @@ Name | Type | Description
 
 ## Get the combined Status for a specific Ref
 
-<div class="alert">
-  <p>
-    The Combined status endpoint is currently available for developers to preview.
-    During the preview period, the API may change without advance notice.
-    Please see the <a href="/changes/2014-03-27-combined-status-api/">blog post</a> for full details.
-  </p>
-  <p>
-    To access this endpoint during the preview period, you must provide a custom
-    <a href="/v3/media/">media type</a> in the <code>Accept</code> header:
-    <pre><%= combined_media_type %></pre>
-  </p>
-</div>
-
 Users with pull access can access a combined view of commit statuses for a given ref.
 
     GET /repos/:owner/:repo/commits/:ref/status
