repo sync

content/rest/overview/media-types.md

@@ -21,81 +21,52 @@ formats that other resources don't.
 
 All {% data variables.product.product_name %} media types look like this:
 
-    application/vnd.github[.version].param[+json]
+    application/vnd.github.param[+json]
 
 The most basic media types the API supports are:
 
-    application/json
     application/vnd.github+json
-
-Neither of these specify a [version][versions], so you will always get the
-current default JSON representation of resources.
+    application/json
 
 {% note %}
 
-**Important:** The default version of the API may change in the
-future. If you're building an application and care about the stability of
-the API, be sure to request a specific version in the `Accept`
-header as shown in the examples below.
+**Note:** In the past, we recommended including `v3` in your `Accept` header. This is no longer required and will have no impact on your API requests.
 
 {% endnote %}
 
-You can specify a version like so:
-
-    application/vnd.github.v3+json
-
 If you're specifying a property (such as full/raw/etc defined below),
-put the version before the property:
+put it after `github`:
 
-    application/vnd.github.v3.raw+json
-
-You can check the current version through every response's headers.  Look
-for the `X-GitHub-Media-Type` header:
-
-```shell
-$ curl {% data variables.product.api_url_pre %}/users/technoweenie -I
-> HTTP/2 200
-> X-GitHub-Media-Type: github.v3
-
-$ curl {% data variables.product.api_url_pre %}/users/technoweenie -I \
-$  -H "Accept: application/vnd.github.full+json"
-> HTTP/2 200
-> X-GitHub-Media-Type: github.v3; param=full; format=json
-
-$ curl {% data variables.product.api_url_pre %}/users/technoweenie -I \
-$  -H "Accept: application/vnd.github.v3.full+json"
-> HTTP/2 200
-> X-GitHub-Media-Type: github.v3; param=full; format=json
-```
+    application/vnd.github.raw+json
 
 ## Comment body properties
 
 The body of a comment can be written in [GitHub Flavored Markdown][gfm], [issues](/rest/reference/issues), [issue comments](/rest/reference/issues#comments), [pull request comments](/rest/reference/pulls#comments), and the [gist comments](/rest/reference/gists#comments) APIs all accept these same media types:
 
 ### Raw
 
-    application/vnd.github.VERSION.raw+json
+    application/vnd.github.raw+json
 
 Return the raw markdown body. Response will include `body`. This is the
 default if you do not pass any specific media type.
 
 ### Text
 
-    application/vnd.github.VERSION.text+json
+    application/vnd.github.text+json
 
 Return a text only representation of the markdown body. Response will
 include `body_text`.
 
 ### HTML
 
-    application/vnd.github.VERSION.html+json
+    application/vnd.github.html+json
 
 Return HTML rendered from the body's markdown. Response will include
 `body_html`.
 
 ### Full
 
-    application/vnd.github.VERSION.full+json
+    application/vnd.github.full+json
 
 Return raw, text and HTML representations. Response will include `body`,
 `body_text`, and `body_html`:
@@ -106,15 +77,15 @@ The following media types are allowed when [getting a blob](/rest/reference/git#
 
 ### JSON
 
-    application/vnd.github.VERSION+json
+    application/vnd.github+json
     application/json
 
 Return JSON representation of the blob with `content` as a base64
 encoded string. This is the default if nothing is passed.
 
 ### Raw
 
-    application/vnd.github.VERSION.raw
+    application/vnd.github.raw
 
 Return the raw blob data.
 
@@ -125,41 +96,41 @@ The [commits API](/rest/reference/repos#commits) and [pull requests API](/rest/r
 
 ### diff
 
-    application/vnd.github.VERSION.diff
+    application/vnd.github.diff
 
 ### patch
 
-    application/vnd.github.VERSION.patch
+    application/vnd.github.patch
 
 ### sha
 
-    application/vnd.github.VERSION.sha
+    application/vnd.github.sha
 
 ## Repository contents
 
 ### Raw
 
-    application/vnd.github.VERSION.raw
+    application/vnd.github.raw
 
 Return the raw contents of a file. This is the default if you do not pass any specific media type.
 
 ### HTML
 
-    application/vnd.github.VERSION.html
+    application/vnd.github.html
 
 For markup files such as Markdown or AsciiDoc, you can retrieve the rendered HTML using the `.html` media type. Markup languages are rendered to HTML using our open-source [Markup library](https://github.com/github/markup).
 
 ## Gists
 
 ### Raw
 
-    application/vnd.github.VERSION.raw
+    application/vnd.github.raw
 
 Return the raw contents of a gist. This is the default if you do not pass any specific media type.
 
 ### base64
 
-    application/vnd.github.VERSION.base64
+    application/vnd.github.base64
 
 The gist contents are base64-encoded before being sent out. This can be useful if your gist contains any invalid UTF-8 sequences.