Sunset content attachments (#23285)

Author: Sarah Edwards

content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md

@@ -60,8 +60,8 @@ The complete list of available query parameters, permissions, and events is list
 `webhook_active` | `boolean` | Set to `false` to disable webhook. Webhook is enabled by default.
 `webhook_url` | `string` | The full URL that you would like to send webhook event payloads to.
 {% ifversion ghes < 3.2 or ghae %}`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details.
-{% endif %}`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.
-`domain` | `string` | The URL of a content reference.
+{% endif %}`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.{% ifversion ghes < 3.4 %}
+`domain` | `string` | The URL of a content reference.{% endif %}
 `single_file_name` | `string` | This is a narrowly-scoped permission that allows the app to access a single file in any repository. When you set the `single_file` permission to `read` or `write`, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. {% ifversion fpt or ghes or ghec %} If you need to manage multiple files, see `single_file_paths` below. {% endif %}{% ifversion fpt or ghes or ghec %}
 `single_file_paths` | `array of strings` | This allows the app to access up ten specified files in a repository. When you set the `single_file` permission to `read` or `write`, this array can store the paths for up to ten files that your {% data variables.product.prodname_github_app %} will manage. These files all receive the same permission set by `single_file`, and do not have separate individual permissions. When two or more files are configured, the API returns `multiple_single_files=true`, otherwise it returns `multiple_single_files=false`.{% endif %}
 
@@ -73,8 +73,8 @@ Permission | Description
 ---------- | -----------
 [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% ifversion fpt or ghec %}
 [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/rest/reference/users#blocking). Can be one of: `none`, `read`, or `write`.{% endif %}
-[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`.
-`content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`.
+[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`.{% ifversion ghes < 3.4 %}
+`content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`.{% endif %}
 [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) |  Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`.
 [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`.{% ifversion fpt or ghes or ghec %}
 [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/rest/reference/users#emails). Can be one of: `none`, `read`, or `write`.{% endif %}
@@ -109,8 +109,8 @@ Webhook event name | Required permission | Description
 ------------------ | ------------------- | -----------
 [`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %}
 [`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %}
-[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %}
-[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %}
+[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %}{% ifversion ghes < 3.4 %}
+[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %}{% endif %}
 [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %}
 [`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %}
 [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %}

content/developers/apps/guides/using-content-attachments.md

@@ -5,10 +5,7 @@ redirect_from:
   - /apps/using-content-attachments
   - /developers/apps/using-content-attachments
 versions:
-  fpt: '*'
-  ghes: '*'
-  ghae: '*'
-  ghec: '*'
+  ghes: '<3.4'
 topics:
   - GitHub Apps
 ---

content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md

@@ -218,6 +218,7 @@ Key | Type | Description
 
 {{ webhookPayloadsForCurrentVersion.commit_comment.created }}
 
+{% ifversion ghes < 3.4 %}
 ## content_reference
 
 {% data reusables.webhooks.content_reference_short_desc %}
@@ -232,6 +233,7 @@ Webhook events are triggered based on the specificity of the domain you register
 
 {{ webhookPayloadsForCurrentVersion.content_reference.created }}
 
+{% endif %}
 ## create
 
 {% data reusables.webhooks.create_short_desc %}

content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md

@@ -242,6 +242,7 @@ For more information, see "[Autolinked references and URLs](/articles/autolinked
 
 {% data reusables.repositories.autolink-references %}
 
+{% ifversion ghes < 3.4 %}
 ## Content attachments
 
 Some {% data variables.product.prodname_github_apps %} provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} renders the information provided by the app under the URL in the body or comment of an issue or pull request.
@@ -252,7 +253,7 @@ To see content attachments, you must have a {% data variables.product.prodname_g
 
 Content attachments will not be displayed for URLs that are part of a markdown link.
 
-For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."
+For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."{% endif %}
 
 ## Uploading assets
 

content/rest/overview/api-previews.md

@@ -183,13 +183,15 @@ You can now configure whether organization members can create repositories and w
 
 {% endif %}
 
+{% ifversion ghes < 3.4 %}
 ## Content attachments
 
 You can now provide more information in GitHub for URLs that link to registered domains by using the {% data variables.product.prodname_unfurls %} API. See "[Using content attachments](/apps/using-content-attachments/)" for more details.
 
 **Custom media types:** `corsair-preview`
 **Announced:** [2018-12-10](https://developer.github.com/changes/2018-12-10-content-attachments-api/)
 
+{% endif %}
 {% ifversion ghae or ghes < 3.3 %}
 
 ## Enable and disable Pages

…m/content_reference.created.payload.json …0/content_reference.created.payload.jsonlib/webhooks/static/dotcom/content_reference.created.payload.json renamed to lib/webhooks/static/ghes-3.0/content_reference.created.payload.json lib/webhooks/static/dotcom/content_reference.created.payload.json renamed to lib/webhooks/static/ghes-3.0/content_reference.created.payload.json

@@ -0,0 +1,125 @@
+{
+  "action": "created",
+  "content_reference": {
+    "id": 17,
+    "node_id": "MDE2OkNvbnRlbnRSZWZlcmVuY2UxNjA5",
+    "reference": "https://errors.ai/"
+  },
+  "repository": {
+    "id": 145551601,
+    "node_id": "MDEwOlJlcG9zaXRvcnkxNDU1NTE2MDE=",
+    "name": "hello-world",
+    "full_name": "octocoders/hello-world",
+    "private": true,
+    "owner": {
+      "login": "Codertocat",
+      "id": 7718702,
+      "node_id": "MDQ6VXNlcjc3MTg3MDI=",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7718702?v=4",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/Codertocat",
+      "html_url": "https://github.com/Codertocat",
+      "followers_url": "https://api.github.com/users/Codertocat/followers",
+      "following_url": "https://api.github.com/users/Codertocat/following{/other_user}",
+      "gists_url": "https://api.github.com/users/Codertocat/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/Codertocat/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/Codertocat/subscriptions",
+      "organizations_url": "https://api.github.com/users/Codertocat/orgs",
+      "repos_url": "https://api.github.com/users/Codertocat/repos",
+      "events_url": "https://api.github.com/users/Codertocat/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/Codertocat/received_events",
+      "type": "User",
+      "site_admin": true
+    },
+    "html_url": "https://github.com/Codertocat/hello-world",
+    "description": null,
+    "fork": false,
+    "url": "https://api.github.com/repos/Codertocat/hello-world",
+    "forks_url": "https://api.github.com/repos/Codertocat/hello-world/forks",
+    "keys_url": "https://api.github.com/repos/Codertocat/hello-world/keys{/key_id}",
+    "collaborators_url": "https://api.github.com/repos/Codertocat/hello-world/collaborators{/collaborator}",
+    "teams_url": "https://api.github.com/repos/Codertocat/hello-world/teams",
+    "hooks_url": "https://api.github.com/repos/Codertocat/hello-world/hooks",
+    "issue_events_url": "https://api.github.com/repos/Codertocat/hello-world/issues/events{/number}",
+    "events_url": "https://api.github.com/repos/Codertocat/hello-world/events",
+    "assignees_url": "https://api.github.com/repos/Codertocat/hello-world/assignees{/user}",
+    "branches_url": "https://api.github.com/repos/Codertocat/hello-world/branches{/branch}",
+    "tags_url": "https://api.github.com/repos/Codertocat/hello-world/tags",
+    "blobs_url": "https://api.github.com/repos/Codertocat/hello-world/git/blobs{/sha}",
+    "git_tags_url": "https://api.github.com/repos/Codertocat/hello-world/git/tags{/sha}",
+    "git_refs_url": "https://api.github.com/repos/Codertocat/hello-world/git/refs{/sha}",
+    "trees_url": "https://api.github.com/repos/Codertocat/hello-world/git/trees{/sha}",
+    "statuses_url": "https://api.github.com/repos/Codertocat/hello-world/statuses/{sha}",
+    "languages_url": "https://api.github.com/repos/Codertocat/hello-world/languages",
+    "stargazers_url": "https://api.github.com/repos/Codertocat/hello-world/stargazers",
+    "contributors_url": "https://api.github.com/repos/Codertocat/hello-world/contributors",
+    "subscribers_url": "https://api.github.com/repos/Codertocat/hello-world/subscribers",
+    "subscription_url": "https://api.github.com/repos/Codertocat/hello-world/subscription",
+    "commits_url": "https://api.github.com/repos/Codertocat/hello-world/commits{/sha}",
+    "git_commits_url": "https://api.github.com/repos/Codertocat/hello-world/git/commits{/sha}",
+    "comments_url": "https://api.github.com/repos/Codertocat/hello-world/comments{/number}",
+    "issue_comment_url": "https://api.github.com/repos/Codertocat/hello-world/issues/comments{/number}",
+    "contents_url": "https://api.github.com/repos/Codertocat/hello-world/contents/{+path}",
+    "compare_url": "https://api.github.com/repos/Codertocat/hello-world/compare/{base}...{head}",
+    "merges_url": "https://api.github.com/repos/Codertocat/hello-world/merges",
+    "archive_url": "https://api.github.com/repos/Codertocat/hello-world/{archive_format}{/ref}",
+    "downloads_url": "https://api.github.com/repos/Codertocat/hello-world/downloads",
+    "issues_url": "https://api.github.com/repos/Codertocat/hello-world/issues{/number}",
+    "pulls_url": "https://api.github.com/repos/Codertocat/hello-world/pulls{/number}",
+    "milestones_url": "https://api.github.com/repos/Codertocat/hello-world/milestones{/number}",
+    "notifications_url": "https://api.github.com/repos/Codertocat/hello-world/notifications{?since,all,participating}",
+    "labels_url": "https://api.github.com/repos/Codertocat/hello-world/labels{/name}",
+    "releases_url": "https://api.github.com/repos/Codertocat/hello-world/releases{/id}",
+    "deployments_url": "https://api.github.com/repos/Codertocat/hello-world/deployments",
+    "created_at": "2018-08-21T10:58:58Z",
+    "updated_at": "2018-08-21T10:59:01Z",
+    "pushed_at": "2018-08-21T10:59:00Z",
+    "git_url": "git://github.com/Codertocat/hello-world.git",
+    "ssh_url": "git@github.com:Codertocat/hello-world.git",
+    "clone_url": "https://github.com/Codertocat/hello-world.git",
+    "svn_url": "https://github.com/Codertocat/hello-world",
+    "homepage": null,
+    "size": 0,
+    "stargazers_count": 0,
+    "watchers_count": 0,
+    "language": null,
+    "has_issues": true,
+    "has_projects": true,
+    "has_downloads": true,
+    "has_wiki": true,
+    "has_pages": false,
+    "forks_count": 0,
+    "mirror_url": null,
+    "archived": false,
+    "open_issues_count": 2,
+    "license": null,
+    "forks": 0,
+    "open_issues": 2,
+    "watchers": 0,
+    "default_branch": "master"
+  },
+  "sender": {
+    "login": "Codertocat",
+    "id": 7718702,
+    "node_id": "MDQ6VXNlcjc3MTg3MDI=",
+    "avatar_url": "https://avatars1.githubusercontent.com/u/7718702?v=4",
+    "gravatar_id": "",
+    "url": "https://api.github.com/users/Codertocat",
+    "html_url": "https://github.com/Codertocat",
+    "followers_url": "https://api.github.com/users/Codertocat/followers",
+    "following_url": "https://api.github.com/users/Codertocat/following{/other_user}",
+    "gists_url": "https://api.github.com/users/Codertocat/gists{/gist_id}",
+    "starred_url": "https://api.github.com/users/Codertocat/starred{/owner}{/repo}",
+    "subscriptions_url": "https://api.github.com/users/Codertocat/subscriptions",
+    "organizations_url": "https://api.github.com/users/Codertocat/orgs",
+    "repos_url": "https://api.github.com/users/Codertocat/repos",
+    "events_url": "https://api.github.com/users/Codertocat/events{/privacy}",
+    "received_events_url": "https://api.github.com/users/Codertocat/received_events",
+    "type": "User",
+    "site_admin": true
+  },
+  "installation": {
+    "id": 371641,
+    "node_id": "MDIzOkludGVncmF0aW9uSW5zdGFsbGF0aW9uMzcxNjQx"
+  }
+}