diff --git a/.github/ISSUE_COMMENT_TEMPLATE/target-date.yml b/.github/ISSUE_COMMENT_TEMPLATE/target-date.yml
new file mode 100644
index 0000000000..a78b022f6d
--- /dev/null
+++ b/.github/ISSUE_COMMENT_TEMPLATE/target-date.yml
@@ -0,0 +1,14 @@
+---
+name: Target Date Update
+about: Target date update
+body:
+- type: input
+ attributes:
+ name: Target completion date
+ placeholder: With context if the target completion date has changed
+ inputType: text
+- type: input
+ attributes:
+ name: 'Attribution'
+ value: '_created with :heart: by typing_ `/status`'
+ inputType: text
diff --git a/assets/images/help/billing/ghas-seats-org.png b/assets/images/help/billing/ghas-seats-org.png
deleted file mode 100644
index 14b78d9e4f..0000000000
Binary files a/assets/images/help/billing/ghas-seats-org.png and /dev/null differ
diff --git a/assets/images/help/notifications-v2/mobile-watch-button.png b/assets/images/help/notifications-v2/mobile-watch-button.png
new file mode 100644
index 0000000000..b5a3fa3af0
Binary files /dev/null and b/assets/images/help/notifications-v2/mobile-watch-button.png differ
diff --git a/assets/images/help/notifications-v2/mobile-watch-settings.png b/assets/images/help/notifications-v2/mobile-watch-settings.png
new file mode 100644
index 0000000000..9b6a485bfa
Binary files /dev/null and b/assets/images/help/notifications-v2/mobile-watch-settings.png differ
diff --git a/assets/images/help/package-registry/ghes-packages-diagram.png b/assets/images/help/package-registry/ghes-packages-diagram.png
deleted file mode 100644
index 7006ce5c96..0000000000
Binary files a/assets/images/help/package-registry/ghes-packages-diagram.png and /dev/null differ
diff --git a/assets/images/help/package-registry/packages-overview-diagram.png b/assets/images/help/package-registry/packages-overview-diagram.png
index adf499d586..50f07869cc 100644
Binary files a/assets/images/help/package-registry/packages-overview-diagram.png and b/assets/images/help/package-registry/packages-overview-diagram.png differ
diff --git a/content/README.md b/content/README.md
index 79aa0fca8b..45b571c323 100644
--- a/content/README.md
+++ b/content/README.md
@@ -228,9 +228,9 @@ includeGuides:
- Optional.
### `topics`
-- Purpose: Indicate the topics covered by the article.
-- Type: `String`
-- Optional.
+- Purpose: Indicate the topics covered by the article. The topics are used to filter guides on some landing pages. For example, the guides at the bottom of [this page](https://docs.github.com/en/actions/guides) can be filtered by topics and the topics are listed under the guide intro. Topics are also added to all search records that get created for each page. The search records contain a `topics` property that is used to filter search results by topics. For more information, see the [Search](/contributing/search.md) contributing guide. Refer to the content models for more details around adding topics. A full list of existing topics is located in the [allowed topics file](/data/allowed-topics.js). If topics in article frontmatter and the allow-topics list become out of sync, the [topics CI test](/tests/unit/search/topics.js) will fail.
+- Type: Array of `String`s
+- Optional: Topics are preferred for each article, but, there may be cases where existing articles don't yet have topics or a adding a topic to a new article may not add value.
### `contributor`
- Purpose: Indicate an article is contributed and maintained by a third-party organization, typically a GitHub Technology Partner.
diff --git a/content/actions/guides/adding-labels-to-issues.md b/content/actions/guides/adding-labels-to-issues.md
new file mode 100644
index 0000000000..618af66b80
--- /dev/null
+++ b/content/actions/guides/adding-labels-to-issues.md
@@ -0,0 +1,68 @@
+---
+title: Adding labels to issues
+intro: You can use {% data variables.product.prodname_actions %} to automatically label issues.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`andymckay/labeler` action](https://github.com/marketplace/actions/simple-issue-labeler) in a workflow to label newly opened or reopened issues. For example, you can add the `triage` label every time an issue is opened or reopened. Then, you can see all issues that need to be triaged by filtering for issues with the `triage` label.
+
+In the tutorial, you will first make a workflow file that uses the [`andymckay/labeler` action](https://github.com/marketplace/actions/simple-issue-labeler). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. {% data reusables.actions.make-workflow-file %}
+3. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Label issues
+ on:
+ issues:
+ types:
+ - reopened
+ - opened
+ jobs:
+ label_issues:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Label issues
+ uses: andymckay/labeler@1.0.2
+ with:
+ add-labels: "triage"
+ ```
+ {% endraw %}
+4. Customize the parameters in your workflow file:
+ - Change the value for `add-labels` to the list of labels that you want to add to the issue. Separate multiple labels with commas. For example, `"help wanted, good first issue"`. For more information about labels, see "[Managing labels](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)."
+5. {% data reusables.actions.commit-workflow %}
+
+### Testing the workflow
+
+Every time an issue in your repository is opened or reopened, this workflow will add the labels that you specified to the issue.
+
+Test out your workflow by creating an issue in your repository.
+
+1. Create an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
+2. To see the workflow run that was triggered by creating the issue, view the history of your workflow runs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+3. When the workflow completes, the issue that you created should have the specified labels added.
+
+### Next steps
+
+- To learn more about additional things you can do with the `andymckay/labeler` action, like removing labels or skipping this action if the issue is assigned or has a specific label, see the [`andymckay/labeler` action documentation](https://github.com/marketplace/actions/simple-issue-labeler).
+- To learn more about different events that can trigger your workflow, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#issues)." The `andymckay/labeler` action only works on `issues`, `pull_request`, or `project_card` events.
+- [Search GitHub](https://github.com/search?q=%22uses:+andymckay/labeler%22&type=code) for examples of workflows using this action.
diff --git a/content/actions/guides/closing-inactive-issues.md b/content/actions/guides/closing-inactive-issues.md
new file mode 100644
index 0000000000..461ef0aca2
--- /dev/null
+++ b/content/actions/guides/closing-inactive-issues.md
@@ -0,0 +1,77 @@
+---
+title: Closing inactive issues
+intro: You can use {% data variables.product.prodname_actions %} to comment on or close issues that have been inactive for a certain period of time.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`actions/stale` action](https://github.com/marketplace/actions/close-stale-issues) to comment on and close issues that have been inactive for a certain period of time. For example, you can comment if an issue has been inactive for 30 days to prompt participants to take action. Then, if no additional activity occurs after 14 days, you can close the issue.
+
+In the tutorial, you will first make a workflow file that uses the [`actions/stale` action](https://github.com/marketplace/actions/close-stale-issues). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. {% data reusables.actions.make-workflow-file %}
+3. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Close inactive issues
+ on:
+ schedule:
+ - cron: "30 1 * * *"
+
+ jobs:
+ close-issues:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/stale@v3
+ with:
+ days-before-issue-stale: 30
+ days-before-issue-close: 14
+ stale-issue-label: "stale"
+ stale-issue-message: "This issue is stale because it has been open for 30 days with no activity."
+ close-issue-message: "This issue was closed because it has been inactive for 14 days since being marked as stale."
+ days-before-pr-stale: -1
+ days-before-pr-close: -1
+ repo-token: ${{ secrets.GITHUB_TOKEN }}
+ ```
+ {% endraw %}
+4. Customize the parameters in your workflow file:
+ - Change the value for `on.schedule` to dictate when you want this workflow to run. In the example above, the workflow will run every day at 1:30 UTC. For more information about scheduled workflows, see "[Scheduled events](/actions/reference/events-that-trigger-workflows#scheduled-events)."
+ - Change the value for `days-before-issue-stale` to the number of days without activity before the `actions/stale` action labels an issue. If you never want this action to label issues, set this value to `-1`.
+ - Change the value for `days-before-issue-close` to the number of days without activity before the `actions/stale` action closes an issue. If you never want this action to close issues, set this value to `-1`.
+ - Change the value for `stale-issue-label` to the label that you want to apply to issues that have been inactive for the amount of time specified by `days-before-issue-stale`.
+ - Change the value for `stale-issue-message` to the comment that you want to add to issues that are labeled by the `actions/stale` action.
+ - Change the value for `close-issue-message` to the comment that you want to add to issues that are closed by the `actions/stale` action.
+5. {% data reusables.actions.commit-workflow %}
+
+### Expected results
+
+Based on the `schedule` parameter (for example, every day at 1:30 UTC), your workflow will find issues that have been inactive for the specified period of time and will add the specified comment and label. Additionally, your workflow will close any previously labeled issues if no additional activity has occurred for the specified period of time.
+
+{% data reusables.actions.schedule-delay %}
+
+You can view the history of your workflow runs to see this workflow run periodically. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+
+This workflow will only label and/or close 30 issues at a time in order to avoid rate limit abuse. You can configure this with the `operations-per-run` setting. For more information, see the [`actions/stale` action documentation](https://github.com/marketplace/actions/close-stale-issues).
+
+### Next steps
+
+- To learn more about additional things you can do with the `actions/stale` action, like closing inactive pull requests, ignoring issues with certain labels or milestones, or only checking issues with certain labels, see the [`actions/stale` action documentation](https://github.com/marketplace/actions/close-stale-issues).
+- [Search GitHub](https://github.com/search?q=%22uses%3A+actions%2Fstale%22&type=code) for examples of workflows using this action.
diff --git a/content/actions/guides/commenting-on-an-issue-when-a-label-is-added.md b/content/actions/guides/commenting-on-an-issue-when-a-label-is-added.md
new file mode 100644
index 0000000000..50f5ad45a4
--- /dev/null
+++ b/content/actions/guides/commenting-on-an-issue-when-a-label-is-added.md
@@ -0,0 +1,70 @@
+---
+title: Commenting on an issue when a label is added
+intro: You can use {% data variables.product.prodname_actions %} to automatically comment on issues when a specific label is applied.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`peter-evans/create-or-update-comment` action](https://github.com/marketplace/actions/create-or-update-comment) to comment on an issue when a specific label is applied. For example, when the `help-wanted` label is added to an issue, you can add a comment to encourage contributors to work on the issue.
+
+In the tutorial, you will first make a workflow file that uses the [`peter-evans/create-or-update-comment` action](https://github.com/marketplace/actions/create-or-update-comment). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. {% data reusables.actions.make-workflow-file %}
+3. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Add comment
+ on:
+ issues:
+ types:
+ - labeled
+ jobs:
+ add-comment:
+ if: github.event.label.name == 'help-wanted'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Add comment
+ uses: peter-evans/create-or-update-comment@v1
+ with:
+ issue-number: ${{ github.event.issue.number }}
+ body: |
+ This issue is available for anyone to work on. **Make sure to reference this issue in your pull request.** :sparkles: Thank you for your contribution! :sparkles:
+ ```
+ {% endraw %}
+4. Customize the parameters in your workflow file:
+ - Replace `help-wanted` in `if: github.event.label.name == 'help-wanted'` with the label that you want to act on. If you want to act on more than one label, separate the conditions with `||`. For example, `if: github.event.label.name == 'bug' || github.event.label.name == 'fix me'` will comment whenever the `bug` or `fix me` labels are added to an issue.
+ - Change the value for `body` to the comment that you want to add. GitHub flavored markdown is supported. For more information about markdown, see "[Basic writing and formatting syntax](/github/writing-on-github/basic-writing-and-formatting-syntax)."
+5. {% data reusables.actions.commit-workflow %}
+
+### Testing the workflow
+
+Every time an issue in your repository is labeled, this workflow will run. If the label that was added is one of the labels that you specified in your workflow file, the `peter-evans/create-or-update-comment` action will add the comment that you specified to the issue.
+
+Test your workflow by applying your specified label to an issue.
+
+1. Open an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
+2. Label the issue with the specified label in your workflow file. For more information, see "[Managing labels](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)."
+3. To see the workflow run triggered by labeling the issue, view the history of your workflow runs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+4. When the workflow completes, the issue that you labeled should have a comment added.
+
+### Next steps
+
+- To learn more about additional things you can do with the `peter-evans/create-or-update-comment` action, like adding reactions, visit the [`peter-evans/create-or-update-comment` action documentation](https://github.com/marketplace/actions/create-or-update-comment).
diff --git a/content/actions/guides/index.md b/content/actions/guides/index.md
index 38acc21679..85043ac3f7 100644
--- a/content/actions/guides/index.md
+++ b/content/actions/guides/index.md
@@ -62,6 +62,13 @@ includeGuides:
- /actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions
- /actions/learn-github-actions/migrating-from-jenkins-to-github-actions
- /actions/learn-github-actions/migrating-from-travis-ci-to-github-actions
+ - /actions/guides/using-github-actions-for-project-management
+ - /actions/guides/closing-inactive-issues
+ - /actions/guides/scheduling-issue-creation
+ - /actions/guides/adding-labels-to-issues
+ - /actions/guides/commenting-on-an-issue-when-a-label-is-added
+ - /actions/guides/moving-assigned-issues-on-project-boards
+ - /actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column
---
@@ -87,3 +94,11 @@ includeGuides:
+
+
+
+
+
+
+
+
diff --git a/content/actions/guides/moving-assigned-issues-on-project-boards.md b/content/actions/guides/moving-assigned-issues-on-project-boards.md
new file mode 100644
index 0000000000..650cbea90d
--- /dev/null
+++ b/content/actions/guides/moving-assigned-issues-on-project-boards.md
@@ -0,0 +1,75 @@
+---
+title: Moving assigned issues on project boards
+intro: You can use {% data variables.product.prodname_actions %} to automatically move an issue to a specific column on a project board when the issue is assigned.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`alex-page/github-project-automation-plus` action](https://github.com/marketplace/actions/github-project-automation) to automatically move an issue to a specific column on a project board when the issue is assigned. For example, when an issue is assigned, you can move it into the `In Progress` column your project board.
+
+In the tutorial, you will first make a workflow file that uses the [`alex-page/github-project-automation-plus` action](https://github.com/marketplace/actions/github-project-automation). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. In your repository, choose a project board. You can use an existing project, or you can create a new project. For more information about creating a project, see "[Creating a project board](/github/managing-your-work-on-github/creating-a-project-board)."
+3. {% data reusables.actions.make-workflow-file %}
+4. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Move assigned card
+ on:
+ issues:
+ types:
+ - assigned
+ jobs:
+ move-assigned-card:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: alex-page/github-project-automation-plus@v0.3.0
+ with:
+ project: Docs Work
+ column: In Progress
+ repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+ ```
+ {% endraw %}
+5. Customize the parameters in your workflow file:
+ - Change the value for `project` to the name of your project board. If you have multiple project boards with the same name, the `alex-page/github-project-automation-plus` action will act on all projects with the specified name.
+ - Change the value for `column` to the name of the column where you want issues to move when they are assigned.
+ - Change the value for `repo-token`:
+ 1. Create a personal access token with the `repo` scope. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
+ 1. Store this personal access token as a secret in your repository. For more information about storing secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets)."
+ 1. In your workflow file, replace `PERSONAL_ACCESS_TOKEN` with the name of your secret.
+6. {% data reusables.actions.commit-workflow %}
+
+### Testing the workflow
+
+Whenever an issue in your repository is assigned, the issue will be moved to the specified project board column. If the issue is not already on the project board, it will be added to the project board.
+
+If your repository is user-owned, the `alex-page/github-project-automation-plus` action will act on all projects in your repository or user account that have the specified project name and column. Likewise, if your repository is organization-owned, the action will act on all projects in your repository or organization that have the specified project name and column.
+
+Test your workflow by assigning an issue in your repository.
+
+1. Open an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
+2. Assign the issue. For more information, see "[Assigning issues and pull requests to other GitHub users](/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users)."
+3. To see the workflow run that assigning the issue triggered, view the history of your workflow runs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+4. When the workflow completes, the issue that you assigned should be added to the specified project board column.
+
+### Next steps
+
+- To learn more about additional things you can do with the `alex-page/github-project-automation-plus` action, like deleting or archiving project cards, visit the [`alex-page/github-project-automation-plus` action documentation](https://github.com/marketplace/actions/github-project-automation).
diff --git a/content/actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column.md b/content/actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column.md
new file mode 100644
index 0000000000..7ab58f6308
--- /dev/null
+++ b/content/actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column.md
@@ -0,0 +1,75 @@
+---
+title: Removing a label when a card is added to a project board column
+intro: You can use {% data variables.product.prodname_actions %} to automatically remove a label when an issue or pull request is added to a specific column on a project board.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`andymckay/labeler` action](https://github.com/marketplace/actions/simple-issue-labeler) along with a conditional to remove a label from issues and pull requests that are added to a specific column on a project board. For example, you can remove the `needs review` label when project cards are moved into the `Done` column.
+
+In the tutorial, you will first make a workflow file that uses the [`andymckay/labeler` action](https://github.com/marketplace/actions/simple-issue-labeler). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. Choose a project that belongs to the repository. This workflow cannot be used with projects that belong to users or organizations. You can use an existing project, or you can create a new project. For more information about creating a project, see "[Creating a project board](/github/managing-your-work-on-github/creating-a-project-board)."
+3. {% data reusables.actions.make-workflow-file %}
+4. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Remove labels
+ on:
+ project_card:
+ types:
+ - moved
+ jobs:
+ remove_labels:
+ if: github.event.project_card.column_id == '12345678'
+ runs-on: ubuntu-latest
+ steps:
+ - name: remove labels
+ uses: andymckay/labeler@master
+ with:
+ remove-labels: "needs review"
+ ```
+ {% endraw %}
+5. Customize the parameters in your workflow file:
+ - In `github.event.project_card.column_id == '12345678'`, replace `12345678` with the ID of the column where you want to un-label issues and pull requests that are moved there.
+
+ To find the column ID, navigate to your project board. Next to the title of the column, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} then click **Copy column link**. The column ID is the number at the end of the copied link. For example, `24687531` is the column ID for `https://github.com/octocat/octo-repo/projects/1#column-24687531`.
+
+ If you want to act on more than one column, separate the conditions with `||`. For example, `if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321'` will act whenever a project card is added to column `12345678` or column `87654321`. The columns may be on different project boards.
+ - Change the value for `remove-labels` to the list of labels that you want to remove from issues or pull requests that are moved to the specified column(s). Separate multiple labels with commas. For example, `"help wanted, good first issue"`. For more information on labels, see "[Managing labels](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)."
+6. {% data reusables.actions.commit-workflow %}
+
+### Testing the workflow
+
+Every time a project card on a project in your repository moves, this workflow will run. If the card is an issue or a pull request and is moved into the column that you specified, then the workflow will remove the specified labels from the issue or a pull request. Cards that are notes will not be affected.
+
+Test your workflow out by moving an issue on your project into the target column.
+
+1. Open an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
+2. Label the issue with the labels that you want the workflow to remove. For more information, see "[Managing labels](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)."
+3. Add the issue to the project column that you specified in your workflow file. For more information, see "[Adding issues and pull requests to a project board](/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board)."
+4. To see the workflow run that was triggered by adding the issue to the project, view the history of your workflow runs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+5. When the workflow completes, the issue that you added to the project column should have the specified labels removed.
+
+### Next steps
+
+- To learn more about additional things you can do with the `andymckay/labeler` action, like adding labels or skipping this action if the issue is assigned or has a specific label, visit the [`andymckay/labeler` action documentation](https://github.com/marketplace/actions/simple-issue-labeler).
+- [Search GitHub](https://github.com/search?q=%22uses:+andymckay/labeler%22&type=code) for examples of workflows using this action.
diff --git a/content/actions/guides/scheduling-issue-creation.md b/content/actions/guides/scheduling-issue-creation.md
new file mode 100644
index 0000000000..d61c7f7ea6
--- /dev/null
+++ b/content/actions/guides/scheduling-issue-creation.md
@@ -0,0 +1,89 @@
+---
+title: Scheduling issue creation
+intro: You can use {% data variables.product.prodname_actions %} to create an issue on a regular basis for things like daily meetings or quarterly reviews.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'tutorial'
+topics:
+ - 'Workflows'
+ - 'Project management'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data reusables.actions.ae-beta %}
+{% data reusables.actions.ae-self-hosted-runners-notice %}
+
+### Introduction
+
+This tutorial demonstrates how to use the [`imjohnbo/issue-bot` action](https://github.com/marketplace/actions/issue-bot-action) to create an issue on a regular basis. For example, you can create an issue each week to use as the agenda for a team meeting.
+
+In the tutorial, you will first make a workflow file that uses the [`imjohnbo/issue-bot` action](https://github.com/marketplace/actions/issue-bot-action). Then, you will customize the workflow to suit your needs.
+
+### Creating the workflow
+
+1. {% data reusables.actions.choose-repo %}
+2. {% data reusables.actions.make-workflow-file %}
+3. Copy the following YAML contents into your workflow file.
+
+ {% raw %}
+ ```yaml{:copy}
+ name: Weekly Team Sync
+ on:
+ schedule:
+ - cron: 0 07 * * 1
+
+ jobs:
+ create_issue:
+ name: Create team sync issue
+ runs-on: ubuntu-latest
+ steps:
+ - name: Create team sync issue
+ uses: imjohnbo/issue-bot@v3.0
+ with:
+ assignees: "monalisa, doctocat, hubot"
+ labels: "weekly sync, docs-team"
+ title: "Team sync"
+ body: |
+ ### Agenda
+
+ - [ ] Start the recording
+ - [ ] Check-ins
+ - [ ] Discussion points
+ - [ ] Post the recording
+
+ ### Discussion Points
+ Add things to discuss below
+
+ - [Work this week](https://github.com/orgs/github/projects/3)
+ pinned: false
+ close-previous: false
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ ```
+ {% endraw %}
+4. Customize the parameters in your workflow file:
+ - Change the value for `on.schedule` to dictate when you want this workflow to run. In the example above, the workflow will run every Monday at 7:00 UTC. For more information about scheduled workflows, see "[Scheduled events](/actions/reference/events-that-trigger-workflows#scheduled-events)."
+ - Change the value for `assignees` to the list of {% data variables.product.prodname_dotcom %} usernames that you want to assign to the issue.
+ - Change the value for `labels` to the list of labels that you want to apply to the issue.
+ - Change the value for `title` to the title that you want the issue to have.
+ - Change the value for `body` to the text that you want in the issue body. The `|` character allows you to use a multi-line value for this parameter.
+ - If you want to pin this issue in your repository, set `pinned` to `true`. For more information about pinned issues, see "[Pinning an issue to your repository](/articles/pinning-an-issue-to-your-repository)."
+ - If you want to close the previous issue generated by this workflow each time a new issue is created, set `close-previous` to `true`. The workflow will close the most recent issue that has the labels defined in the `labels` field. To avoid closing the wrong issue, use a unique label or combination of labels.
+5. {% data reusables.actions.commit-workflow %}
+
+### Expected results
+
+Based on the `schedule` parameter (for example, every Monday at 7:00 UTC), your workflow will create a new issue with the assignees, labels, title, and body that you specified. If you set `pinned` to `true`, the workflow will pin the issue to your repository. If you set `close-previous` to true, the workflow will close the most recent issue with matching labels.
+
+{% data reusables.actions.schedule-delay %}
+
+You can view the history of your workflow runs to see this workflow run periodically. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
+
+### Next steps
+
+- To learn more about additional things you can do with the `imjohnbo/issue-bot` action, like rotating assignees or using an issue template, see the [`imjohnbo/issue-bot` action documentation](https://github.com/marketplace/actions/issue-bot-action).
+- [Search GitHub](https://github.com/search?q=%22uses%3A+imjohnbo%2Fissue-bot%22&type=code) for examples of workflows using this action.
diff --git a/content/actions/guides/using-github-actions-for-project-management.md b/content/actions/guides/using-github-actions-for-project-management.md
new file mode 100644
index 0000000000..d023cb4e2c
--- /dev/null
+++ b/content/actions/guides/using-github-actions-for-project-management.md
@@ -0,0 +1,40 @@
+---
+title: Using GitHub Actions for project management
+intro: You can use {% data variables.product.prodname_actions %} to automate many of your project management tasks.
+product: '{% data reusables.gated-features.actions %}'
+versions:
+ free-pro-team: '*'
+ enterprise-server: '>=2.22'
+ github-ae: '*'
+type: 'overview'
+topics:
+ - 'Project management'
+---
+
+You can use {% data variables.product.prodname_actions %} to automate your project management tasks by creating workflows. Each workflow contains a series of tasks that are performed automatically every time the workflow runs. For example, you can create a workflow that runs every time an issue is created to add a label, leave a comment, and move the issue onto a project board.
+
+### When do workflows run?
+
+You can configure your workflows to run on a schedule or be triggered when an event occurs. For example, you can set your workflow to run when someone creates an issue in a repository.
+
+Many workflow triggers are useful for automating project management.
+
+- An issue is opened, assigned, or labeled.
+- A comment is added to an issue.
+- A project card is created or moved.
+- A scheduled time.
+
+For a full list of events that can trigger workflows, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."
+
+### What can workflows do?
+
+Workflows can do many things, such as commenting on an issue, adding or removing labels, moving cards on project boards, and opening issues.
+
+You can learn about using {% data variables.product.prodname_actions %} for project management by following these tutorials, which include example workflows that you can adapt to meet your needs.
+
+- "[Adding labels to issues](/actions/guides/adding-labels-to-issues)"
+- "[Removing a label when a card is added to a project board column](/actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column)"
+- "[Moving assigned issues on project boards](/actions/guides/moving-assigned-issues-on-project-boards)"
+- "[Commenting on an issue when a label is added](/actions/guides/commenting-on-an-issue-when-a-label-is-added)"
+- "[Closing inactive issues](/actions/guides/closing-inactive-issues)"
+- "[Scheduling issue creation](/actions/guides/scheduling-issue-creation)"
diff --git a/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/content/actions/learn-github-actions/security-hardening-for-github-actions.md
index 5880ba20fd..d5b53f25cf 100644
--- a/content/actions/learn-github-actions/security-hardening-for-github-actions.md
+++ b/content/actions/learn-github-actions/security-hardening-for-github-actions.md
@@ -123,6 +123,24 @@ For example, you can use the audit log to track the `org.update_actions_secret`
The following tables describe the {% data variables.product.prodname_actions %} events that you can find in the audit log. For more information on using the audit log, see
"[Reviewing the audit log for your organization](/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)."
+{% if currentVersion == "free-pro-team@latest" %}
+#### Events for environments
+
+| Action | Description
+|------------------|-------------------
+| `environment.create_actions_secret` | Triggered when a secret is created in an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+| `environment.delete` | Triggered when an environment is deleted. For more information, see ["Deleting an environment](/actions/reference/environments#deleting-an-environment)."
+| `environment.remove_actions_secret` | Triggered when a secret is removed from an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+| `environment.update_actions_secret` | Triggered when a secret in an environment is updated. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+{% endif %}
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
+#### Events for configuration changes
+| Action | Description
+|------------------|-------------------
+| `repo.actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not visible when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)."
+{% endif %}
+
#### Events for secret management
| Action | Description
|------------------|-------------------
@@ -135,11 +153,15 @@ The following tables describe the {% data variables.product.prodname_actions %}
#### Events for self-hosted runners
| Action | Description
-|------------------|-------------------
+|------------------|-------------------{% if currentVersion ver_gt "enterprise-server@2.21" %}{% else %}
| `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)."
-| `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."
+| `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed.
+| `enterprise.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."
+| `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)."{% endif %}
| `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)."
| `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization).
+| `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."
+| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."
| `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."
| `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)."
| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."
@@ -150,13 +172,13 @@ The following tables describe the {% data variables.product.prodname_actions %}
|------------------|-------------------
| `enterprise.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an enterprise](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)."
| `enterprise.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)."
-| `enterprise.runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group.
+| `enterprise.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group.
| `enterprise.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)."
| `enterprise.runner_group_updated` |Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."
| `org.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an organization](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)."
| `org.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)."
| `org.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)."
-| `org.runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group.
+| `org.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)."
#### Events for workflow activities
diff --git a/content/actions/reference/authentication-in-a-workflow.md b/content/actions/reference/authentication-in-a-workflow.md
index 8805da3d9f..eac1b060d0 100644
--- a/content/actions/reference/authentication-in-a-workflow.md
+++ b/content/actions/reference/authentication-in-a-workflow.md
@@ -40,7 +40,7 @@ This example workflow uses the [labeler action](https://github.com/actions/label
```yaml
name: Pull request labeler
on:
- - pull_request
+ - pull_request_target
jobs:
triage:
runs-on: ubuntu-latest
diff --git a/content/actions/reference/events-that-trigger-workflows.md b/content/actions/reference/events-that-trigger-workflows.md
index 9f3e2327e2..d1e9e8de83 100644
--- a/content/actions/reference/events-that-trigger-workflows.md
+++ b/content/actions/reference/events-that-trigger-workflows.md
@@ -43,11 +43,7 @@ The following steps occur to trigger a workflow run:
The `schedule` event allows you to trigger a workflow at a scheduled time.
-{% note %}
-
-Note: Due to load, the `schedule` event may be delayed
-
-{% endnote %}
+{% data reusables.actions.schedule-delay %}
#### `schedule`
@@ -725,12 +721,14 @@ on:
{% data reusables.github-actions.branch-requirement %}
| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` |
-| --------------------- | -------------- | ------------ | -------------|
-| [`workflow_run`](/webhooks/event-payloads/#workflow_run) | - n/a | Last commit on default branch | Default branch |
+| --------------------- | -------------- | ------------ | -------------|
+| [`workflow_run`](/webhooks/event-payloads/#workflow_run) | - `completed` - `requested` | Last commit on default branch | Default branch |
+
+{% data reusables.developer-site.limit_workflow_to_activity_types %}
If you need to filter branches from this event, you can use `branches` or `branches-ignore`.
-In this example, a workflow is configured to run after the separate “Run Tests” workflow completes.
+In this example, a workflow is configured to run after the separate "Run Tests" workflow completes.
```yaml
on:
@@ -744,6 +742,27 @@ on:
{% endif %}
+To run a workflow job conditionally based on the result of the previous workflow run, you can use the [`jobs..if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) or [`jobs..steps[*].if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif) conditional combined with the `conclusion` of the previous run. For example:
+
+```yaml
+on:
+ workflow_run:
+ workflows: ["Build"]
+ types: [completed]
+
+jobs:
+ on-success:
+ runs-on: ubuntu-latest
+ if: {% raw %}${{ github.event.workflow_run.conclusion == 'success' }}{% endraw %}
+ steps:
+ ...
+ on-failure:
+ runs-on: ubuntu-latest
+ if: {% raw %}${{ github.event.workflow_run.conclusion == 'failure' }}{% endraw %}
+ steps:
+ ...
+```
+
### Triggering new workflows using a personal access token
{% data reusables.github-actions.actions-do-not-trigger-workflows %} For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
diff --git a/content/actions/reference/usage-limits-billing-and-administration.md b/content/actions/reference/usage-limits-billing-and-administration.md
index c59edbf101..2ab089a0ed 100644
--- a/content/actions/reference/usage-limits-billing-and-administration.md
+++ b/content/actions/reference/usage-limits-billing-and-administration.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - billing
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/actions/reference/workflow-syntax-for-github-actions.md b/content/actions/reference/workflow-syntax-for-github-actions.md
index 9883e1bca3..c5431f7372 100644
--- a/content/actions/reference/workflow-syntax-for-github-actions.md
+++ b/content/actions/reference/workflow-syntax-for-github-actions.md
@@ -314,7 +314,6 @@ Available {% data variables.product.prodname_dotcom %}-hosted runner types are:
{% data reusables.github-actions.supported-github-runners %}
-{% data reusables.github-actions.ubuntu-runner-preview %}
{% data reusables.github-actions.macos-runner-preview %}
##### Example
diff --git a/content/actions/using-github-hosted-runners/about-github-hosted-runners.md b/content/actions/using-github-hosted-runners/about-github-hosted-runners.md
index bbcebb10c5..8a6228e0bb 100644
--- a/content/actions/using-github-hosted-runners/about-github-hosted-runners.md
+++ b/content/actions/using-github-hosted-runners/about-github-hosted-runners.md
@@ -55,7 +55,6 @@ Hardware specification for macOS virtual machines:
{% data reusables.github-actions.supported-github-runners %}
-{% data reusables.github-actions.ubuntu-runner-preview %}
{% data reusables.github-actions.macos-runner-preview %}
Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."
diff --git a/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md
index c1ccb9a417..097850a133 100644
--- a/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md
+++ b/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About built-in authentication for users outside your identity provider
diff --git a/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md b/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md
index e21b5d8ae4..cc0d48b47c 100644
--- a/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md
+++ b/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md
@@ -11,5 +11,7 @@ redirect_from:
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/authentication/changing-authentication-methods.md b/content/admin/authentication/changing-authentication-methods.md
index b3f8f58c05..b9a864ebe2 100644
--- a/content/admin/authentication/changing-authentication-methods.md
+++ b/content/admin/authentication/changing-authentication-methods.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/authentication/changing-authentication-methods
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
User accounts on {% data variables.product.product_location %} are preserved when you change the authentication method and users will continue to log into the same account as long as their username doesn't change.
diff --git a/content/admin/authentication/disabling-unauthenticated-sign-ups.md b/content/admin/authentication/disabling-unauthenticated-sign-ups.md
index 5987411ce0..cd9861decc 100644
--- a/content/admin/authentication/disabling-unauthenticated-sign-ups.md
+++ b/content/admin/authentication/disabling-unauthenticated-sign-ups.md
@@ -7,6 +7,8 @@ redirect_from:
intro: 'If you''re using built-in authentication, you can block unauthenticated people from being able to create an account.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_site_admin_settings.access-settings %}
diff --git a/content/admin/authentication/index.md b/content/admin/authentication/index.md
index deacdaf76f..b55ee5094f 100644
--- a/content/admin/authentication/index.md
+++ b/content/admin/authentication/index.md
@@ -1,11 +1,13 @@
---
title: Authentication
-intro: You can configure how users sign into {% data variables.product.product_name %}.
+intro: 'You can configure how users sign into {% data variables.product.product_name %}.'
redirect_from:
- /enterprise/admin/authentication
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/authentication/using-built-in-authentication.md b/content/admin/authentication/using-built-in-authentication.md
index 4df510e488..0e05f30cd0 100644
--- a/content/admin/authentication/using-built-in-authentication.md
+++ b/content/admin/authentication/using-built-in-authentication.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/authentication/using-built-in-authentication
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You can create custom messages that users will see on the sign in and sign out pages. For more information, see "[Customizing user messages on your instance](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)."
diff --git a/content/admin/authentication/using-cas.md b/content/admin/authentication/using-cas.md
index fa765d66b8..d5c2985090 100644
--- a/content/admin/authentication/using-cas.md
+++ b/content/admin/authentication/using-cas.md
@@ -8,6 +8,8 @@ redirect_from:
intro: 'CAS is a single sign-on (SSO) protocol for multiple web applications. A CAS user account does not take up a {% if currentVersion ver_gt "enterprise-server@2.16" %}user license{% else %}seat{% endif %} until the user signs in.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_user_management.built-in-authentication %}
diff --git a/content/admin/authentication/using-ldap.md b/content/admin/authentication/using-ldap.md
index 959c6df2fb..53858a708b 100644
--- a/content/admin/authentication/using-ldap.md
+++ b/content/admin/authentication/using-ldap.md
@@ -11,6 +11,8 @@ redirect_from:
intro: 'LDAP lets you authenticate {% data variables.product.prodname_ghe_server %} against your existing accounts and centrally manage repository access. LDAP is a popular application protocol for accessing and maintaining directory information services, and is one of the most common protocols used to integrate third-party software with large company user directories.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_user_management.built-in-authentication %}
diff --git a/content/admin/authentication/using-saml.md b/content/admin/authentication/using-saml.md
index e4cdd3808e..2da3fd18cc 100644
--- a/content/admin/authentication/using-saml.md
+++ b/content/admin/authentication/using-saml.md
@@ -8,6 +8,8 @@ redirect_from:
intro: 'SAML is an XML-based standard for authentication and authorization. {% data variables.product.prodname_ghe_server %} can act as a service provider (SP) with your internal SAML identity provider (IdP).'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_user_management.built-in-authentication %}
diff --git a/content/admin/configuration/about-enterprise-configuration.md b/content/admin/configuration/about-enterprise-configuration.md
index 8f90db0622..1436036526 100644
--- a/content/admin/configuration/about-enterprise-configuration.md
+++ b/content/admin/configuration/about-enterprise-configuration.md
@@ -4,6 +4,8 @@ intro: 'You can use the site admin dashboard{% if enterpriseServerVersions conta
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if enterpriseServerVersions contains currentVersion %}
diff --git a/content/admin/configuration/accessing-the-administrative-shell-ssh.md b/content/admin/configuration/accessing-the-administrative-shell-ssh.md
index 73cf3530c7..939c25bd37 100644
--- a/content/admin/configuration/accessing-the-administrative-shell-ssh.md
+++ b/content/admin/configuration/accessing-the-administrative-shell-ssh.md
@@ -13,6 +13,8 @@ redirect_from:
intro: '{% data reusables.enterprise_site_admin_settings.about-ssh-access %}'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About administrative shell access
diff --git a/content/admin/configuration/accessing-the-management-console.md b/content/admin/configuration/accessing-the-management-console.md
index 94a312d877..62921a128c 100644
--- a/content/admin/configuration/accessing-the-management-console.md
+++ b/content/admin/configuration/accessing-the-management-console.md
@@ -12,6 +12,8 @@ redirect_from:
- /enterprise/admin/configuration/accessing-the-management-console
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About the {% data variables.enterprise.management_console %}
diff --git a/content/admin/configuration/command-line-utilities.md b/content/admin/configuration/command-line-utilities.md
index d10388e2f9..6abacadb3c 100644
--- a/content/admin/configuration/command-line-utilities.md
+++ b/content/admin/configuration/command-line-utilities.md
@@ -9,6 +9,8 @@ redirect_from:
miniTocMaxHeadingLevel: 4
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You can execute these commands from anywhere on the VM after signing in as an SSH admin user. For more information, see "[Accessing the administrative shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)."
diff --git a/content/admin/configuration/configuring-a-hostname.md b/content/admin/configuration/configuring-a-hostname.md
index 3e7bd4b662..981e4abd9f 100644
--- a/content/admin/configuration/configuring-a-hostname.md
+++ b/content/admin/configuration/configuring-a-hostname.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-a-hostname
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
If you configure a hostname instead of a hard-coded IP address, you will be able to change the physical hardware that {% data variables.product.product_location %} runs on without affecting users or client software.
diff --git a/content/admin/configuration/configuring-advanced-security-features.md b/content/admin/configuration/configuring-advanced-security-features.md
index e9a8a1113f..353c1e4246 100644
--- a/content/admin/configuration/configuring-advanced-security-features.md
+++ b/content/admin/configuration/configuring-advanced-security-features.md
@@ -7,5 +7,7 @@ redirect_from:
- /enterprise/admin/configuration/configuring-advanced-security-features
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
diff --git a/content/admin/configuration/configuring-an-outbound-web-proxy-server.md b/content/admin/configuration/configuring-an-outbound-web-proxy-server.md
index 8a398553fa..b58ca8f400 100644
--- a/content/admin/configuration/configuring-an-outbound-web-proxy-server.md
+++ b/content/admin/configuration/configuring-an-outbound-web-proxy-server.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-an-outbound-web-proxy-server
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When a proxy server is enabled for {% data variables.product.product_location %}, outbound messages sent by {% data variables.product.prodname_ghe_server %} are first sent through the proxy server, unless the destination host is added as an HTTP proxy exclusion. Types of outbound messages include outgoing webhooks, uploading bundles, and fetching legacy avatars. The proxy server's URL is the protocol, domain or IP address, plus the port number, for example `http://127.0.0.1:8123`.
diff --git a/content/admin/configuration/configuring-applications.md b/content/admin/configuration/configuring-applications.md
index 534c4c76d9..da0908fc88 100644
--- a/content/admin/configuration/configuring-applications.md
+++ b/content/admin/configuration/configuring-applications.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-applications
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Adjusting image caching
diff --git a/content/admin/configuration/configuring-backups-on-your-appliance.md b/content/admin/configuration/configuring-backups-on-your-appliance.md
index dbea15fc26..62754fac24 100644
--- a/content/admin/configuration/configuring-backups-on-your-appliance.md
+++ b/content/admin/configuration/configuring-backups-on-your-appliance.md
@@ -15,6 +15,8 @@ redirect_from:
intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.product.product_location %} by configuring automated backups.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.prodname_enterprise_backup_utilities %}
diff --git a/content/admin/configuration/configuring-built-in-firewall-rules.md b/content/admin/configuration/configuring-built-in-firewall-rules.md
index 1ee5bcda80..73415a9df1 100644
--- a/content/admin/configuration/configuring-built-in-firewall-rules.md
+++ b/content/admin/configuration/configuring-built-in-firewall-rules.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-built-in-firewall-rules
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.product_location %}'s firewall
diff --git a/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/content/admin/configuration/configuring-code-scanning-for-your-appliance.md
index 7b579bfe1d..152e36452e 100644
--- a/content/admin/configuration/configuring-code-scanning-for-your-appliance.md
+++ b/content/admin/configuration/configuring-code-scanning-for-your-appliance.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-code-scanning-for-your-appliance
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.code-scanning.beta %}
diff --git a/content/admin/configuration/configuring-dns-nameservers.md b/content/admin/configuration/configuring-dns-nameservers.md
index 5e3dd8edbf..89d69a723c 100644
--- a/content/admin/configuration/configuring-dns-nameservers.md
+++ b/content/admin/configuration/configuring-dns-nameservers.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-dns-nameservers
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
The nameservers you specify must resolve {% data variables.product.product_location %}'s hostname.
diff --git a/content/admin/configuration/configuring-email-for-notifications.md b/content/admin/configuration/configuring-email-for-notifications.md
index 665d0177ca..25ae0e9c52 100644
--- a/content/admin/configuration/configuring-email-for-notifications.md
+++ b/content/admin/configuration/configuring-email-for-notifications.md
@@ -1,6 +1,6 @@
---
title: Configuring email for notifications
-intro: To make it easy for users to respond quickly to activity on {% data variables.product.product_name %}, you can configure {% data variables.product.product_location %} to send email notifications for issue, pull request, and commit comments.
+intro: 'To make it easy for users to respond quickly to activity on {% data variables.product.product_name %}, you can configure {% data variables.product.product_location %} to send email notifications for issue, pull request, and commit comments.'
redirect_from:
- /enterprise/admin/guides/installation/email-configuration/
- /enterprise/admin/articles/configuring-email/
@@ -10,6 +10,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if currentVersion == "github-ae@latest" %}
diff --git a/content/admin/configuration/configuring-github-pages-for-your-enterprise.md b/content/admin/configuration/configuring-github-pages-for-your-enterprise.md
index 29a92ff609..3a27d659cc 100644
--- a/content/admin/configuration/configuring-github-pages-for-your-enterprise.md
+++ b/content/admin/configuration/configuring-github-pages-for-your-enterprise.md
@@ -11,6 +11,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Enabling public sites for {% data variables.product.prodname_pages %}
diff --git a/content/admin/configuration/configuring-network-settings.md b/content/admin/configuration/configuring-network-settings.md
index b5d7abf7e0..fe94a7b2b0 100644
--- a/content/admin/configuration/configuring-network-settings.md
+++ b/content/admin/configuration/configuring-network-settings.md
@@ -11,5 +11,7 @@ intro: 'Configure {% data variables.product.prodname_ghe_server %} with the DNS
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/configuration/configuring-rate-limits.md b/content/admin/configuration/configuring-rate-limits.md
index 5cffccdf16..46f56ef79e 100644
--- a/content/admin/configuration/configuring-rate-limits.md
+++ b/content/admin/configuration/configuring-rate-limits.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-rate-limits
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Enabling rate limits for {% data variables.product.prodname_enterprise_api %}
diff --git a/content/admin/configuration/configuring-secret-scanning-for-your-appliance.md b/content/admin/configuration/configuring-secret-scanning-for-your-appliance.md
index b806b45f29..361702b4b3 100644
--- a/content/admin/configuration/configuring-secret-scanning-for-your-appliance.md
+++ b/content/admin/configuration/configuring-secret-scanning-for-your-appliance.md
@@ -6,6 +6,8 @@ product: '{% data reusables.gated-features.secret-scanning %}'
miniTocMaxHeadingLevel: 4
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
{% data reusables.secret-scanning.beta %}
diff --git a/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md
index c8b25b42dc..f814b48cf9 100644
--- a/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md
+++ b/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/configuration/configuring-time-synchronization.md b/content/admin/configuration/configuring-time-synchronization.md
index d9042f873d..a71272ab86 100644
--- a/content/admin/configuration/configuring-time-synchronization.md
+++ b/content/admin/configuration/configuring-time-synchronization.md
@@ -10,6 +10,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-time-synchronization
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Changing the default NTP servers
diff --git a/content/admin/configuration/configuring-tls.md b/content/admin/configuration/configuring-tls.md
index fd106938d1..4b9d1bb375 100644
--- a/content/admin/configuration/configuring-tls.md
+++ b/content/admin/configuration/configuring-tls.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/configuration/configuring-tls
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About Transport Layer Security
diff --git a/content/admin/configuration/configuring-your-enterprise.md b/content/admin/configuration/configuring-your-enterprise.md
index 5afbbe1751..641f5e6109 100644
--- a/content/admin/configuration/configuring-your-enterprise.md
+++ b/content/admin/configuration/configuring-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Configuring your enterprise
-intro: "After {% data variables.product.product_name %} is up and running, you can configure your enterprise to suit your organization's needs."
+intro: 'After {% data variables.product.product_name %} is up and running, you can configure your enterprise to suit your organization''s needs.'
redirect_from:
- /enterprise/admin/guides/installation/basic-configuration/
- /enterprise/admin/guides/installation/administrative-tools/
@@ -12,5 +12,7 @@ mapTopic: true
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md
index f3e412341c..30be76ad51 100644
--- a/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md
+++ b/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md
@@ -10,6 +10,8 @@ redirect_from:
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of a {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% data variables.product.prodname_github_connect %}.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.prodname_github_connect %}
diff --git a/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md
index 8d25c497ef..3311ca6605 100644
--- a/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md
+++ b/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md
@@ -8,6 +8,8 @@ redirect_from:
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md b/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md
index 832241da5f..52dfaa160b 100644
--- a/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md
+++ b/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md
@@ -12,6 +12,8 @@ redirect_from:
- /enterprise/admin/configuration/enabling-and-scheduling-maintenance-mode
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About maintenance mode
diff --git a/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md
index a320a62917..3c161a3171 100644
--- a/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md
+++ b/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md
@@ -7,6 +7,8 @@ redirect_from:
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable automatic user license synchronization.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About license synchronization
diff --git a/content/admin/configuration/enabling-private-mode.md b/content/admin/configuration/enabling-private-mode.md
index 831e440b7f..1e32ab673f 100644
--- a/content/admin/configuration/enabling-private-mode.md
+++ b/content/admin/configuration/enabling-private-mode.md
@@ -9,6 +9,8 @@ redirect_from:
- /enterprise/admin/configuration/enabling-private-mode
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You must enable private mode if {% data variables.product.product_location %} is publicly accessible over the Internet. In private mode, users cannot anonymously clone repositories over `git://`. If built-in authentication is also enabled, an administrator must invite new users to create an account on the instance. For more information, see "[Using built-in authentication](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)."
diff --git a/content/admin/configuration/enabling-subdomain-isolation.md b/content/admin/configuration/enabling-subdomain-isolation.md
index 76012af69f..782d4033e7 100644
--- a/content/admin/configuration/enabling-subdomain-isolation.md
+++ b/content/admin/configuration/enabling-subdomain-isolation.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/enabling-subdomain-isolation
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About subdomain isolation
diff --git a/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md
index 7c85654bea..2d609c74fb 100644
--- a/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md
+++ b/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md
@@ -10,6 +10,8 @@ redirect_from:
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable unified contributions between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_dotcom_the_website %}.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
As a site administrator, you can allow end users to send anonymized contribution counts for their work from {% data variables.product.prodname_ghe_server %} to their {% data variables.product.prodname_dotcom_the_website %} contribution graph.
diff --git a/content/admin/configuration/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/content/admin/configuration/enabling-unified-search-between-github-enterprise-server-and-githubcom.md
index 33130ca6fe..d34e2ebdba 100644
--- a/content/admin/configuration/enabling-unified-search-between-github-enterprise-server-and-githubcom.md
+++ b/content/admin/configuration/enabling-unified-search-between-github-enterprise-server-and-githubcom.md
@@ -10,6 +10,8 @@ redirect_from:
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable unified search between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_dotcom_the_website %}.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When you enable unified search, users can view search results from public and private content on {% data variables.product.prodname_dotcom_the_website %} when searching from {% data variables.product.product_location_enterprise %}.
diff --git a/content/admin/configuration/index.md b/content/admin/configuration/index.md
index ee042551f2..1cfa0079a8 100644
--- a/content/admin/configuration/index.md
+++ b/content/admin/configuration/index.md
@@ -1,12 +1,14 @@
---
title: Configuring GitHub Enterprise
shortTitle: Configuring GitHub Enterprise
-intro: "You can configure your enterprise to suit your organization's needs."
+intro: You can configure your enterprise to suit your organization's needs.
redirect_from:
- /enterprise/admin/configuration
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if currentVersion ver_gt "enterprise-server@2.21" %}
diff --git a/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md
index 63e4e25bee..1fd17e838e 100644
--- a/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md
+++ b/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md
@@ -11,5 +11,7 @@ redirect_from:
- /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/configuration/managing-github-for-mobile-for-your-enterprise.md b/content/admin/configuration/managing-github-for-mobile-for-your-enterprise.md
index 66de92b8f4..fb7b3fe2dc 100644
--- a/content/admin/configuration/managing-github-for-mobile-for-your-enterprise.md
+++ b/content/admin/configuration/managing-github-for-mobile-for-your-enterprise.md
@@ -1,9 +1,11 @@
---
title: Managing GitHub for mobile for your enterprise
-intro: You can decide whether authenticated users can connect to {% data variables.product.product_location %} with {% data variables.product.prodname_mobile %}.
-permissions: Enterprise owners can manage {% data variables.product.prodname_mobile %} for an enterprise on {% data variables.product.product_name %}.
+intro: 'You can decide whether authenticated users can connect to {% data variables.product.product_location %} with {% data variables.product.prodname_mobile %}.'
+permissions: 'Enterprise owners can manage {% data variables.product.prodname_mobile %} for an enterprise on {% data variables.product.product_name %}.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
{% if enterpriseServerVersions contains currentVersion %}
diff --git a/content/admin/configuration/network-ports.md b/content/admin/configuration/network-ports.md
index 9a4688b5f2..22f578d8d3 100644
--- a/content/admin/configuration/network-ports.md
+++ b/content/admin/configuration/network-ports.md
@@ -10,6 +10,8 @@ redirect_from:
intro: 'Open network ports selectively based on the network services you need to expose for administrators, end users, and email support.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Administrative ports
diff --git a/content/admin/configuration/site-admin-dashboard.md b/content/admin/configuration/site-admin-dashboard.md
index da953a8cd3..df0c325292 100644
--- a/content/admin/configuration/site-admin-dashboard.md
+++ b/content/admin/configuration/site-admin-dashboard.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/site-admin-dashboard
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
To access the dashboard, in the upper-right corner of any page, click {% octicon "rocket" aria-label="The rocket ship" %}.
diff --git a/content/admin/configuration/troubleshooting-ssl-errors.md b/content/admin/configuration/troubleshooting-ssl-errors.md
index 61c4bb3ce9..8271cc47b2 100644
--- a/content/admin/configuration/troubleshooting-ssl-errors.md
+++ b/content/admin/configuration/troubleshooting-ssl-errors.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/configuration/troubleshooting-ssl-errors
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Removing the passphrase from your key file
diff --git a/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md b/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md
index 539b679d73..869cc35ff0 100644
--- a/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md
+++ b/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/configuration/using-github-enterprise-server-with-a-load-balancer
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_clustering.load_balancer_intro %}
diff --git a/content/admin/configuration/validating-your-domain-settings.md b/content/admin/configuration/validating-your-domain-settings.md
index 1c731a310c..581679b205 100644
--- a/content/admin/configuration/validating-your-domain-settings.md
+++ b/content/admin/configuration/validating-your-domain-settings.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/configuration/validating-your-domain-settings
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_site_admin_settings.access-settings %}
{% data reusables.enterprise_site_admin_settings.management-console %}
diff --git a/content/admin/enterprise-management/about-cluster-nodes.md b/content/admin/enterprise-management/about-cluster-nodes.md
index 74a1a75fe3..463b8781a0 100644
--- a/content/admin/enterprise-management/about-cluster-nodes.md
+++ b/content/admin/enterprise-management/about-cluster-nodes.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/about-cluster-nodes
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_clustering.clustering-requires-https %}
diff --git a/content/admin/enterprise-management/about-clustering.md b/content/admin/enterprise-management/about-clustering.md
index 8b3345da85..1a1157bb0d 100644
--- a/content/admin/enterprise-management/about-clustering.md
+++ b/content/admin/enterprise-management/about-clustering.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/about-clustering
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Clustering architecture
diff --git a/content/admin/enterprise-management/about-geo-replication.md b/content/admin/enterprise-management/about-geo-replication.md
index dfa868e556..b72945375b 100644
--- a/content/admin/enterprise-management/about-geo-replication.md
+++ b/content/admin/enterprise-management/about-geo-replication.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/about-geo-replication
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Multiple active replicas can provide a shorter distance to the nearest replica. For example, an organization with offices in San Francisco, New York, and London could run the primary appliance in a datacenter near New York and two replicas in datacenters near San Francisco and London. Using geolocation-aware DNS, users can be directed to the closest server available and access repository data faster. Designating the appliance near New York as the primary helps reduce the latency between the hosts, compared to the appliance near San Francisco being the primary which has a higher latency to London.
diff --git a/content/admin/enterprise-management/about-high-availability-configuration.md b/content/admin/enterprise-management/about-high-availability-configuration.md
index 724be83b78..19b5449371 100644
--- a/content/admin/enterprise-management/about-high-availability-configuration.md
+++ b/content/admin/enterprise-management/about-high-availability-configuration.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/about-high-availability-configuration
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When you configure high availability, there is an automated setup of one-way, asynchronous replication of all datastores (Git repositories, MySQL, Redis, and Elasticsearch) from the primary to the replica appliance.
diff --git a/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/content/admin/enterprise-management/accessing-the-monitor-dashboard.md
index a83ec1d359..b7182b0edf 100644
--- a/content/admin/enterprise-management/accessing-the-monitor-dashboard.md
+++ b/content/admin/enterprise-management/accessing-the-monitor-dashboard.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/accessing-the-monitor-dashboard
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Accessing the monitor dashboard
diff --git a/content/admin/enterprise-management/cluster-network-configuration.md b/content/admin/enterprise-management/cluster-network-configuration.md
index b11cc7bb1f..80f91507d7 100644
--- a/content/admin/enterprise-management/cluster-network-configuration.md
+++ b/content/admin/enterprise-management/cluster-network-configuration.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/cluster-network-configuration
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Network considerations
diff --git a/content/admin/enterprise-management/configuring-clustering.md b/content/admin/enterprise-management/configuring-clustering.md
index 6fc9f34af1..6752ddf050 100644
--- a/content/admin/enterprise-management/configuring-clustering.md
+++ b/content/admin/enterprise-management/configuring-clustering.md
@@ -9,5 +9,7 @@ redirect_from:
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/enterprise-management/configuring-collectd.md b/content/admin/enterprise-management/configuring-collectd.md
index 4196beb841..7ce2e846c8 100644
--- a/content/admin/enterprise-management/configuring-collectd.md
+++ b/content/admin/enterprise-management/configuring-collectd.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/configuring-collectd
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Set up an external `collectd` server
diff --git a/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md b/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md
index 9cf229f154..deb7ebbf60 100644
--- a/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md
+++ b/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster
versions:
enterprise-server: '>2.21'
+topics:
+ - enterprise
---
### About high availability replication for clusters
diff --git a/content/admin/enterprise-management/configuring-high-availability.md b/content/admin/enterprise-management/configuring-high-availability.md
index 84b7b0ae9f..bd994c7848 100644
--- a/content/admin/enterprise-management/configuring-high-availability.md
+++ b/content/admin/enterprise-management/configuring-high-availability.md
@@ -10,5 +10,7 @@ intro: '{% data variables.product.prodname_ghe_server %} supports a high availab
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/enterprise-management/creating-a-high-availability-replica.md b/content/admin/enterprise-management/creating-a-high-availability-replica.md
index 9c124a1eb8..8a032953fb 100644
--- a/content/admin/enterprise-management/creating-a-high-availability-replica.md
+++ b/content/admin/enterprise-management/creating-a-high-availability-replica.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/creating-a-high-availability-replica
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Creating a high availability replica
diff --git a/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md b/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md
index 9ac3ba2f73..59d4847dd9 100644
--- a/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md
+++ b/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/differences-between-clustering-and-high-availability-ha
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Failure scenarios
diff --git a/content/admin/enterprise-management/enabling-automatic-update-checks.md b/content/admin/enterprise-management/enabling-automatic-update-checks.md
index 07f741e1bc..3c53bfa0a5 100644
--- a/content/admin/enterprise-management/enabling-automatic-update-checks.md
+++ b/content/admin/enterprise-management/enabling-automatic-update-checks.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/enabling-automatic-update-checks
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When an upgrade package is automatically downloaded for {% data variables.product.product_location %}, you'll receive a message letting you know you can upgrade {% data variables.product.prodname_ghe_server %}. Packages download to the `/var/lib/ghe-updates` directory on {% data variables.product.product_location %}. For more information, see "[Upgrading {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)."
diff --git a/content/admin/enterprise-management/evacuating-a-cluster-node.md b/content/admin/enterprise-management/evacuating-a-cluster-node.md
index c429e92707..a93e152668 100644
--- a/content/admin/enterprise-management/evacuating-a-cluster-node.md
+++ b/content/admin/enterprise-management/evacuating-a-cluster-node.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/evacuating-a-cluster-node
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
If you only have three nodes in your data services cluster, you can't evacuate the nodes, because `ghe-spokes` doesn’t have another place to make a copy. If you have four or more, `ghe-spokes` will move all the repositories off of the evacuated node.
diff --git a/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md b/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md
index 70ad38778a..ce3e4a1acd 100644
--- a/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md
+++ b/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/increasing-cpu-or-memory-resources
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %}
diff --git a/content/admin/enterprise-management/increasing-storage-capacity.md b/content/admin/enterprise-management/increasing-storage-capacity.md
index 2c893b226e..1db8208731 100644
--- a/content/admin/enterprise-management/increasing-storage-capacity.md
+++ b/content/admin/enterprise-management/increasing-storage-capacity.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/increasing-storage-capacity
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %}
diff --git a/content/admin/enterprise-management/index.md b/content/admin/enterprise-management/index.md
index faaf069973..cc6f503d0a 100644
--- a/content/admin/enterprise-management/index.md
+++ b/content/admin/enterprise-management/index.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/enterprise-management
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/enterprise-management/initializing-the-cluster.md b/content/admin/enterprise-management/initializing-the-cluster.md
index 1fc88c484a..4ada134284 100644
--- a/content/admin/enterprise-management/initializing-the-cluster.md
+++ b/content/admin/enterprise-management/initializing-the-cluster.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/initializing-the-cluster
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise_clustering.clustering-requires-https %}
diff --git a/content/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance.md b/content/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance.md
index 208fe0e10d..7a9d0c47f5 100644
--- a/content/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance.md
+++ b/content/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
The time required to failover depends on how long it takes to manually promote the replica and redirect traffic. The average time ranges between 2-10 minutes.
diff --git a/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md b/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md
index 2b0406038c..baa4b482d3 100644
--- a/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md
+++ b/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster
versions:
enterprise-server: '>2.21'
+topics:
+ - enterprise
---
### About failover to your replica cluster
diff --git a/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md b/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md
index 5369335124..f28668eb3a 100644
--- a/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md
+++ b/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md
@@ -12,6 +12,8 @@ redirect_from:
intro: 'To migrate from {% data variables.product.prodname_enterprise %} 11.10.x to 2.1.23, you''ll need to set up a new appliance instance and migrate data from the previous instance.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Migrations from {% data variables.product.prodname_enterprise %} 11.10.348 and later are supported. Migrating from {% data variables.product.prodname_enterprise %} 11.10.348 and earlier is not supported. You must first upgrade to 11.10.348 in several upgrades. For more information, see the 11.10.348 upgrading procedure, "[Upgrading to the latest release](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)."
diff --git a/content/admin/enterprise-management/monitoring-cluster-nodes.md b/content/admin/enterprise-management/monitoring-cluster-nodes.md
index da5fcdd1c9..4916df38ad 100644
--- a/content/admin/enterprise-management/monitoring-cluster-nodes.md
+++ b/content/admin/enterprise-management/monitoring-cluster-nodes.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/monitoring-cluster-nodes
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Manually checking cluster status
diff --git a/content/admin/enterprise-management/monitoring-using-snmp.md b/content/admin/enterprise-management/monitoring-using-snmp.md
index 2ef67fbbef..bcc5821b39 100644
--- a/content/admin/enterprise-management/monitoring-using-snmp.md
+++ b/content/admin/enterprise-management/monitoring-using-snmp.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/monitoring-using-snmp
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
SNMP is a common standard for monitoring devices over a network. We strongly recommend enabling SNMP so you can monitor the health of {% data variables.product.product_location %} and know when to add more memory, storage, or processor power to the host machine.
diff --git a/content/admin/enterprise-management/monitoring-your-appliance.md b/content/admin/enterprise-management/monitoring-your-appliance.md
index e8adac6a11..a73f9c02e3 100644
--- a/content/admin/enterprise-management/monitoring-your-appliance.md
+++ b/content/admin/enterprise-management/monitoring-your-appliance.md
@@ -9,5 +9,7 @@ redirect_from:
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/enterprise-management/recommended-alert-thresholds.md b/content/admin/enterprise-management/recommended-alert-thresholds.md
index ceae6ab760..3898e09a0b 100644
--- a/content/admin/enterprise-management/recommended-alert-thresholds.md
+++ b/content/admin/enterprise-management/recommended-alert-thresholds.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/recommended-alert-thresholds
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Monitoring storage
diff --git a/content/admin/enterprise-management/recovering-a-high-availability-configuration.md b/content/admin/enterprise-management/recovering-a-high-availability-configuration.md
index 879390f390..cc9cd0027e 100644
--- a/content/admin/enterprise-management/recovering-a-high-availability-configuration.md
+++ b/content/admin/enterprise-management/recovering-a-high-availability-configuration.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/recovering-a-high-availability-configuration
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You can use the former primary appliance as the new replica appliance if the failover was planned or was not related to the health of the appliance. If the failover was related to an issue with the primary appliance, you may prefer to create a new replica appliance. For more information, see "[Creating a high availability replica](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)."
diff --git a/content/admin/enterprise-management/removing-a-high-availability-replica.md b/content/admin/enterprise-management/removing-a-high-availability-replica.md
index 6002b89d1b..7f3ab841b7 100644
--- a/content/admin/enterprise-management/removing-a-high-availability-replica.md
+++ b/content/admin/enterprise-management/removing-a-high-availability-replica.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/removing-a-high-availability-replica
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Stopping replication temporarily
diff --git a/content/admin/enterprise-management/replacing-a-cluster-node.md b/content/admin/enterprise-management/replacing-a-cluster-node.md
index 4dde19d038..2f96afbd7d 100644
--- a/content/admin/enterprise-management/replacing-a-cluster-node.md
+++ b/content/admin/enterprise-management/replacing-a-cluster-node.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/replacing-a-cluster-node
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% warning %}
diff --git a/content/admin/enterprise-management/setting-up-external-monitoring.md b/content/admin/enterprise-management/setting-up-external-monitoring.md
index f0163ff946..21031f8d8f 100644
--- a/content/admin/enterprise-management/setting-up-external-monitoring.md
+++ b/content/admin/enterprise-management/setting-up-external-monitoring.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/setting-up-external-monitoring
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About SNMP
diff --git a/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md b/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md
index 3c590160d0..b40afca279 100644
--- a/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md
+++ b/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md
@@ -9,5 +9,7 @@ redirect_from:
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/enterprise-management/upgrade-requirements.md b/content/admin/enterprise-management/upgrade-requirements.md
index 60da0b3d30..c06792a751 100644
--- a/content/admin/enterprise-management/upgrade-requirements.md
+++ b/content/admin/enterprise-management/upgrade-requirements.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/upgrade-requirements
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/enterprise-management/upgrading-a-cluster.md b/content/admin/enterprise-management/upgrading-a-cluster.md
index 1be8e7d8b5..19fd10ebcd 100644
--- a/content/admin/enterprise-management/upgrading-a-cluster.md
+++ b/content/admin/enterprise-management/upgrading-a-cluster.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/upgrading-a-cluster
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Upgrading with a hotpatch
{% data reusables.enterprise_installation.hotpatching-explanation %} The hotpatch installation script installs the hotpatch on every node in the cluster and restarts the services in their proper sequence to avoid downtime.
diff --git a/content/admin/enterprise-management/upgrading-github-enterprise-server.md b/content/admin/enterprise-management/upgrading-github-enterprise-server.md
index daefc6db50..a839c03410 100644
--- a/content/admin/enterprise-management/upgrading-github-enterprise-server.md
+++ b/content/admin/enterprise-management/upgrading-github-enterprise-server.md
@@ -15,6 +15,8 @@ redirect_from:
- /enterprise/admin/enterprise-management/upgrading-github-enterprise-server
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Preparing to upgrade
@@ -251,4 +253,4 @@ To roll back from a feature release, restore from a VM snapshot to ensure that r
### Further reading
- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)"
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/admin/enterprise-support/about-github-enterprise-support.md b/content/admin/enterprise-support/about-github-enterprise-support.md
index 696ce3441c..f731cfec52 100644
--- a/content/admin/enterprise-support/about-github-enterprise-support.md
+++ b/content/admin/enterprise-support/about-github-enterprise-support.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md b/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md
index ecdcf02322..de2131bec7 100644
--- a/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md
+++ b/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md b/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md
index b55487a008..8553ddf3da 100644
--- a/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md
+++ b/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/enterprise-support/about-support-for-advanced-security.md b/content/admin/enterprise-support/about-support-for-advanced-security.md
index f1eadede3a..d9f8d78ef9 100644
--- a/content/admin/enterprise-support/about-support-for-advanced-security.md
+++ b/content/admin/enterprise-support/about-support-for-advanced-security.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/enterprise-support/about-support-for-advanced-security
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% note %}
diff --git a/content/admin/enterprise-support/index.md b/content/admin/enterprise-support/index.md
index d6f1ed9191..1393d3bc81 100644
--- a/content/admin/enterprise-support/index.md
+++ b/content/admin/enterprise-support/index.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Table of Contents
diff --git a/content/admin/enterprise-support/overview.md b/content/admin/enterprise-support/overview.md
index 67f3ad9d93..ce8e4498c5 100644
--- a/content/admin/enterprise-support/overview.md
+++ b/content/admin/enterprise-support/overview.md
@@ -7,4 +7,7 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/enterprise-support/preparing-to-submit-a-ticket.md b/content/admin/enterprise-support/preparing-to-submit-a-ticket.md
index 9c70a25abf..4f0ebdb6d5 100644
--- a/content/admin/enterprise-support/preparing-to-submit-a-ticket.md
+++ b/content/admin/enterprise-support/preparing-to-submit-a-ticket.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
Before submitting a ticket, you should:
@@ -24,4 +26,4 @@ Especially for tickets with {% data variables.product.support_ticket_priority_ur
- Be knowledgeable in your internal systems, tools, policies, and practices.
- Be a proficient user of {% data variables.product.product_name %}.
- Have full access and permissions to any services that are required to troubleshoot the issue.
- - Be authorized to make the recommended changes to your network and any applicable products.
\ No newline at end of file
+ - Be authorized to make the recommended changes to your network and any applicable products.
diff --git a/content/admin/enterprise-support/providing-data-to-github-support.md b/content/admin/enterprise-support/providing-data-to-github-support.md
index 2bb07afaab..3ea6981372 100644
--- a/content/admin/enterprise-support/providing-data-to-github-support.md
+++ b/content/admin/enterprise-support/providing-data-to-github-support.md
@@ -8,6 +8,8 @@ redirect_from:
- /enterprise/admin/enterprise-support/providing-data-to-github-support
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Creating and sharing diagnostic files
diff --git a/content/admin/enterprise-support/reaching-github-support.md b/content/admin/enterprise-support/reaching-github-support.md
index 7cf256ce56..51d55999d7 100644
--- a/content/admin/enterprise-support/reaching-github-support.md
+++ b/content/admin/enterprise-support/reaching-github-support.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/enterprise-support/reaching-github-support
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Using automated ticketing systems
diff --git a/content/admin/enterprise-support/receiving-help-from-github-support.md b/content/admin/enterprise-support/receiving-help-from-github-support.md
index 98b3cd0eea..c700ae6897 100644
--- a/content/admin/enterprise-support/receiving-help-from-github-support.md
+++ b/content/admin/enterprise-support/receiving-help-from-github-support.md
@@ -8,4 +8,7 @@ mapTopic: true
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/enterprise-support/submitting-a-ticket.md b/content/admin/enterprise-support/submitting-a-ticket.md
index 5f396e34ca..cb16823728 100644
--- a/content/admin/enterprise-support/submitting-a-ticket.md
+++ b/content/admin/enterprise-support/submitting-a-ticket.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### About submitting a ticket
diff --git a/content/admin/github-actions/about-using-actions-on-github-enterprise-server.md b/content/admin/github-actions/about-using-actions-on-github-enterprise-server.md
index 3b3b6da7eb..e87d29f61f 100644
--- a/content/admin/github-actions/about-using-actions-on-github-enterprise-server.md
+++ b/content/admin/github-actions/about-using-actions-on-github-enterprise-server.md
@@ -6,6 +6,8 @@ redirect_from:
- /admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/admin/github-actions/advanced-configuration-and-troubleshooting.md b/content/admin/github-actions/advanced-configuration-and-troubleshooting.md
index fa3f0a4aa7..609640ef99 100644
--- a/content/admin/github-actions/advanced-configuration-and-troubleshooting.md
+++ b/content/admin/github-actions/advanced-configuration-and-troubleshooting.md
@@ -4,4 +4,7 @@ intro: 'Configure high availability for {% data variables.product.prodname_actio
mapTopic: true
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md b/content/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
index a2556020e8..1a687f2e87 100644
--- a/content/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
+++ b/content/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
@@ -4,6 +4,8 @@ shortTitle: Backing up and restoring
intro: '{% data variables.product.prodname_actions %} data on your external storage provider is not included in regular {% data variables.product.prodname_ghe_server %} backups, and must be backed up separately.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-storage-ha-backups %}
diff --git a/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
index 5be9397384..8235057e02 100644
--- a/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
+++ b/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server.md b/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server.md
index 886b40a786..1ab36ce2a1 100644
--- a/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server.md
+++ b/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server.md
@@ -4,4 +4,7 @@ intro: 'Learn how to configure storage and enable {% data variables.product.prod
mapTopic: true
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/github-actions/enabling-github-actions-with-amazon-s3-storage.md b/content/admin/github-actions/enabling-github-actions-with-amazon-s3-storage.md
index 1e94369d98..f545d49494 100644
--- a/content/admin/github-actions/enabling-github-actions-with-amazon-s3-storage.md
+++ b/content/admin/github-actions/enabling-github-actions-with-amazon-s3-storage.md
@@ -4,6 +4,8 @@ intro: 'You can enable {% data variables.product.prodname_actions %} on {% data
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/github-actions/enabling-github-actions-with-azure-blob-storage.md b/content/admin/github-actions/enabling-github-actions-with-azure-blob-storage.md
index a9b21f3001..1245137438 100644
--- a/content/admin/github-actions/enabling-github-actions-with-azure-blob-storage.md
+++ b/content/admin/github-actions/enabling-github-actions-with-azure-blob-storage.md
@@ -4,6 +4,8 @@ intro: 'You can enable {% data variables.product.prodname_actions %} on {% data
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage.md b/content/admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage.md
index d86f1a64b5..ba2c6c47ab 100644
--- a/content/admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage.md
+++ b/content/admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage.md
@@ -4,6 +4,8 @@ intro: 'You can enable {% data variables.product.prodname_actions %} on {% data
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md
index 82df246b43..b9f5e4fcf2 100644
--- a/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md
+++ b/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - enterprise
---
{% data reusables.actions.ae-beta %}
diff --git a/content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md b/content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md
index 534f37520e..4cba468196 100644
--- a/content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md
+++ b/content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md
@@ -7,6 +7,8 @@ redirect_from:
- /admin/github-actions/enabling-github-actions-and-configuring-storage
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/admin/github-actions/high-availability-for-github-actions.md b/content/admin/github-actions/high-availability-for-github-actions.md
index 26ccc90fba..c893e6c059 100644
--- a/content/admin/github-actions/high-availability-for-github-actions.md
+++ b/content/admin/github-actions/high-availability-for-github-actions.md
@@ -3,6 +3,8 @@ title: High availability for GitHub Actions
intro: 'There are some special considerations for administering {% data variables.product.prodname_actions %} in a high availability configuration.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
### Replication or redundancy of your {% data variables.product.prodname_actions %} data
diff --git a/content/admin/github-actions/index.md b/content/admin/github-actions/index.md
index e95b18f98a..6caf9cf8e2 100644
--- a/content/admin/github-actions/index.md
+++ b/content/admin/github-actions/index.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - enterprise
---
{% data reusables.actions.ae-beta %}
diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom.md
index 51d601c89f..78e01a4ca3 100644
--- a/content/admin/github-actions/managing-access-to-actions-from-githubcom.md
+++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom.md
@@ -6,5 +6,7 @@ redirect_from:
- /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
diff --git a/content/admin/github-actions/manually-syncing-actions-from-githubcom.md b/content/admin/github-actions/manually-syncing-actions-from-githubcom.md
index f36947c4bc..3f8f07e6ba 100644
--- a/content/admin/github-actions/manually-syncing-actions-from-githubcom.md
+++ b/content/admin/github-actions/manually-syncing-actions-from-githubcom.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/github-actions/manually-syncing-actions-from-githubcom
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
index dfc57ac64b..a380a9961e 100644
--- a/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
+++ b/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/admin/github-actions/troubleshooting-github-actions-for-your-enterprise.md b/content/admin/github-actions/troubleshooting-github-actions-for-your-enterprise.md
index df08b0d047..5ef91e72d9 100644
--- a/content/admin/github-actions/troubleshooting-github-actions-for-your-enterprise.md
+++ b/content/admin/github-actions/troubleshooting-github-actions-for-your-enterprise.md
@@ -4,6 +4,8 @@ intro: 'Troubleshooting common issues that occur when using {% data variables.pr
permissions: 'Site administrators can troubleshoot {% data variables.product.prodname_actions %} issues and modify {% data variables.product.prodname_ghe_server %} configurations.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
### Configuring self-hosted runners when using a self-signed certificate for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/github-actions/using-a-staging-environment.md b/content/admin/github-actions/using-a-staging-environment.md
index f2d387de55..d463c8a01c 100644
--- a/content/admin/github-actions/using-a-staging-environment.md
+++ b/content/admin/github-actions/using-a-staging-environment.md
@@ -3,6 +3,8 @@ title: Using a staging environment
intro: 'Learn about using {% data variables.product.prodname_actions %} with {% data variables.product.prodname_ghe_server %} staging environments.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
It can be useful to have a staging or testing environment for {% data variables.product.product_location %}, so that you can test updates or new features before implementing them in your production environment.
diff --git a/content/admin/installation/index.md b/content/admin/installation/index.md
index ca489927cc..582246e33e 100644
--- a/content/admin/installation/index.md
+++ b/content/admin/installation/index.md
@@ -11,6 +11,8 @@ redirect_from:
- /enterprise/admin/installation
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
For more information, or to purchase {% data variables.product.prodname_enterprise %}, see [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise).
diff --git a/content/admin/installation/installing-github-enterprise-server-on-aws.md b/content/admin/installation/installing-github-enterprise-server-on-aws.md
index 50d3baa627..f6de6fe0ee 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-aws.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-aws.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-aws
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/installing-github-enterprise-server-on-azure.md b/content/admin/installation/installing-github-enterprise-server-on-azure.md
index be1006b3f7..008413e67e 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-azure.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-azure.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-azure
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You can deploy {% data variables.product.prodname_ghe_server %} on global Azure or Azure Government.
diff --git a/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md
index e21838d06a..6f80158971 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-google-cloud-platform
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/installing-github-enterprise-server-on-hyper-v.md b/content/admin/installation/installing-github-enterprise-server-on-hyper-v.md
index 42a146e2f9..eded2b581a 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-hyper-v.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-hyper-v.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-hyper-v
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md
index 2695c4d612..79453ba7f6 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-openstack-kvm
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/installing-github-enterprise-server-on-vmware.md b/content/admin/installation/installing-github-enterprise-server-on-vmware.md
index ce4f58e9bb..0646a0cdea 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-vmware.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-vmware.md
@@ -9,6 +9,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-vmware
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/installing-github-enterprise-server-on-xenserver.md b/content/admin/installation/installing-github-enterprise-server-on-xenserver.md
index fb0341074d..7b87108661 100644
--- a/content/admin/installation/installing-github-enterprise-server-on-xenserver.md
+++ b/content/admin/installation/installing-github-enterprise-server-on-xenserver.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/installation/installing-github-enterprise-server-on-xenserver
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Prerequisites
diff --git a/content/admin/installation/setting-up-a-github-enterprise-server-instance.md b/content/admin/installation/setting-up-a-github-enterprise-server-instance.md
index 92a5f510c9..865536adbe 100644
--- a/content/admin/installation/setting-up-a-github-enterprise-server-instance.md
+++ b/content/admin/installation/setting-up-a-github-enterprise-server-instance.md
@@ -10,5 +10,7 @@ redirect_from:
mapTopic: true
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/installation/setting-up-a-staging-instance.md b/content/admin/installation/setting-up-a-staging-instance.md
index 972f5439d3..082e71f7fe 100644
--- a/content/admin/installation/setting-up-a-staging-instance.md
+++ b/content/admin/installation/setting-up-a-staging-instance.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/installation/setting-up-a-staging-instance
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% tip %}
@@ -28,4 +30,4 @@ To thoroughly test a {% data variables.product.prodname_ghe_server %} appliance
### Further reading
- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)"
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/admin/overview/about-enterprise-accounts.md b/content/admin/overview/about-enterprise-accounts.md
index 4c37b9eed5..42352b9ac1 100644
--- a/content/admin/overview/about-enterprise-accounts.md
+++ b/content/admin/overview/about-enterprise-accounts.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
enterprise-server: '>=2.20'
github-ae: '*'
+topics:
+ - enterprise
---
### About enterprise accounts on {% data variables.product.product_name %}
diff --git a/content/admin/overview/about-the-github-enterprise-api.md b/content/admin/overview/about-the-github-enterprise-api.md
index 8f75a39a07..d79b6c703a 100644
--- a/content/admin/overview/about-the-github-enterprise-api.md
+++ b/content/admin/overview/about-the-github-enterprise-api.md
@@ -11,6 +11,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
With the APIs, you can automate many administrative tasks. Some examples include:
diff --git a/content/admin/overview/about-upgrades-to-new-releases.md b/content/admin/overview/about-upgrades-to-new-releases.md
index f25eeb31ca..475fea0e5f 100644
--- a/content/admin/overview/about-upgrades-to-new-releases.md
+++ b/content/admin/overview/about-upgrades-to-new-releases.md
@@ -5,6 +5,8 @@ intro: '{% if currentVersion == "github-ae@latest" %}Your {% data variables.prod
versions:
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - enterprise
---
{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through major and minor releases. {% if currentVersion == "github-ae@latest" %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %}
diff --git a/content/admin/overview/managing-billing-for-your-enterprise.md b/content/admin/overview/managing-billing-for-your-enterprise.md
index 97c0ba8c03..8b8000cdc4 100644
--- a/content/admin/overview/managing-billing-for-your-enterprise.md
+++ b/content/admin/overview/managing-billing-for-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Managing billing for your enterprise
-intro: 'You can view billing information for your enterprise.'
+intro: You can view billing information for your enterprise.
product: '{% data reusables.gated-features.enterprise-accounts %}'
redirect_from:
- /enterprise/admin/installation/managing-billing-for-github-enterprise
@@ -9,6 +9,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if currentVersion == "github-ae@latest" %}
diff --git a/content/admin/overview/managing-your-github-enterprise-license.md b/content/admin/overview/managing-your-github-enterprise-license.md
index b5c69a8999..5318d5ca08 100644
--- a/content/admin/overview/managing-your-github-enterprise-license.md
+++ b/content/admin/overview/managing-your-github-enterprise-license.md
@@ -14,6 +14,8 @@ redirect_from:
- /enterprise/admin/overview/managing-your-github-enterprise-license
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.prodname_enterprise %} licenses
diff --git a/content/admin/overview/system-overview.md b/content/admin/overview/system-overview.md
index c86afe795a..a84cc7b275 100644
--- a/content/admin/overview/system-overview.md
+++ b/content/admin/overview/system-overview.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/overview/system-overview
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Storage architecture
diff --git a/content/admin/packages/configuring-package-ecosystem-support-for-your-enterprise.md b/content/admin/packages/configuring-package-ecosystem-support-for-your-enterprise.md
index 1f15dc49c2..b544920183 100644
--- a/content/admin/packages/configuring-package-ecosystem-support-for-your-enterprise.md
+++ b/content/admin/packages/configuring-package-ecosystem-support-for-your-enterprise.md
@@ -6,6 +6,8 @@ redirect_from:
- /admin/packages/configuring-packages-support-for-your-enterprise
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/admin/packages/enabling-github-packages-with-aws.md b/content/admin/packages/enabling-github-packages-with-aws.md
index 4cfb1b0123..d1ac35a260 100644
--- a/content/admin/packages/enabling-github-packages-with-aws.md
+++ b/content/admin/packages/enabling-github-packages-with-aws.md
@@ -3,6 +3,8 @@ title: Enabling GitHub Packages with AWS
intro: 'Set up {% data variables.product.prodname_registry %} with AWS as your external storage.'
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% warning %}
diff --git a/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md b/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md
index 65fd365621..913cfba14c 100644
--- a/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md
+++ b/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md
@@ -3,6 +3,8 @@ title: Enabling GitHub Packages with Azure Blob Storage
intro: 'Set up {% data variables.product.prodname_registry %} with Azure Blob Storage as your external storage.'
versions:
enterprise-server: '>=3.0'
+topics:
+ - enterprise
---
{% warning %}
diff --git a/content/admin/packages/enabling-github-packages-with-minio.md b/content/admin/packages/enabling-github-packages-with-minio.md
index b0cec33688..9123b05147 100644
--- a/content/admin/packages/enabling-github-packages-with-minio.md
+++ b/content/admin/packages/enabling-github-packages-with-minio.md
@@ -3,6 +3,8 @@ title: Enabling GitHub Packages with MinIO
intro: 'Set up {% data variables.product.prodname_registry %} with MinIO as your external storage.'
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% warning %}
diff --git a/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md b/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md
index 9f92df1f87..16aae55c86 100644
--- a/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md
+++ b/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md
@@ -6,6 +6,8 @@ redirect_from:
- /admin/packages/enabling-github-packages-for-your-enterprise
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% if currentVersion == "enterprise-server@2.22" %}
diff --git a/content/admin/packages/index.md b/content/admin/packages/index.md
index 9808ef3fde..b4f90820e7 100644
--- a/content/admin/packages/index.md
+++ b/content/admin/packages/index.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/packages
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md b/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md
index 646d1454a2..fc418b26e2 100644
--- a/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md
+++ b/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md
@@ -3,6 +3,8 @@ title: Quickstart for configuring your MinIO storage bucket for GitHub Packages
intro: 'Configure your custom MinIO storage bucket for use with {% data variables.product.prodname_registry %}.'
versions:
enterprise-server: '>=2.22'
+topics:
+ - enterprise
---
{% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/admin/policies/about-pre-receive-hooks.md b/content/admin/policies/about-pre-receive-hooks.md
index ec699e2ccf..effb31b1b4 100644
--- a/content/admin/policies/about-pre-receive-hooks.md
+++ b/content/admin/policies/about-pre-receive-hooks.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/policies/about-pre-receive-hooks
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When a push occurs, each script runs in an isolated environment and can perform checks on the content of the push. The scripts will cause the push to be accepted if the exit status is 0, or rejected if the exit status is non-zero.
diff --git a/content/admin/policies/creating-a-pre-receive-hook-environment.md b/content/admin/policies/creating-a-pre-receive-hook-environment.md
index 64ab4099fc..f798129733 100644
--- a/content/admin/policies/creating-a-pre-receive-hook-environment.md
+++ b/content/admin/policies/creating-a-pre-receive-hook-environment.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/policies/creating-a-pre-receive-hook-environment
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
A pre-receive environment for {% data variables.product.prodname_ghe_server %} is a Linux [`chroot`](https://en.wikipedia.org/wiki/Chroot) environment. Because pre-receive hooks execute on every push event, they should be fast and lightweight. The environment needed for such checks will typically be minimal.
diff --git a/content/admin/policies/creating-a-pre-receive-hook-script.md b/content/admin/policies/creating-a-pre-receive-hook-script.md
index c501d76e58..71f3a8e971 100644
--- a/content/admin/policies/creating-a-pre-receive-hook-script.md
+++ b/content/admin/policies/creating-a-pre-receive-hook-script.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/policies/creating-a-pre-receive-hook-script
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
You can see examples of pre-receive hooks for {% data variables.product.prodname_ghe_server %} in the [`github/platform-samples` repository](https://github.com/github/platform-samples/tree/master/pre-receive-hooks).
diff --git a/content/admin/policies/enforcing-policies-for-your-enterprise.md b/content/admin/policies/enforcing-policies-for-your-enterprise.md
index b3673275fc..c5583b723d 100644
--- a/content/admin/policies/enforcing-policies-for-your-enterprise.md
+++ b/content/admin/policies/enforcing-policies-for-your-enterprise.md
@@ -6,5 +6,7 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md
index 49c8daec91..62f4721a65 100644
--- a/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md
+++ b/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md
@@ -7,5 +7,7 @@ redirect_from:
- /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md
index de657754d3..adb7c0bf50 100644
--- a/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md
+++ b/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md
@@ -28,6 +28,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Configuring the default visibility of new repositories in your enterprise
@@ -242,4 +244,4 @@ If necessary, you can prevent repository administrators from changing anonymous
5. Click **Update**.
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/admin/policies/index.md b/content/admin/policies/index.md
index 9c665ea894..2588b9ba09 100644
--- a/content/admin/policies/index.md
+++ b/content/admin/policies/index.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md
index 806dd27df9..78a8dbb31f 100644
--- a/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md
+++ b/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md
@@ -7,6 +7,8 @@ redirect_from:
- /enterprise/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Creating pre-receive hooks
diff --git a/content/admin/release-notes.md b/content/admin/release-notes.md
index 4010feb879..3608580c91 100644
--- a/content/admin/release-notes.md
+++ b/content/admin/release-notes.md
@@ -1,7 +1,10 @@
---
title: Release notes
-intro: The release notes for {{ allVersions[currentVersion].versionTitle }}.
+intro: 'The release notes for {{ allVersions[currentVersion].versionTitle }}.'
layout: release-notes
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/user-management/about-migrations.md b/content/admin/user-management/about-migrations.md
index e04bdf4f4a..4761a77561 100644
--- a/content/admin/user-management/about-migrations.md
+++ b/content/admin/user-management/about-migrations.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/user-management/about-migrations
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Types of migrations
diff --git a/content/admin/user-management/activity-dashboard.md b/content/admin/user-management/activity-dashboard.md
index 5fb4fce0d9..36572f7c90 100644
--- a/content/admin/user-management/activity-dashboard.md
+++ b/content/admin/user-management/activity-dashboard.md
@@ -1,6 +1,6 @@
---
title: Activity dashboard
-intro: 'The Activity dashboard gives you an overview of all the activity in your enterprise.'
+intro: The Activity dashboard gives you an overview of all the activity in your enterprise.
redirect_from:
- /enterprise/admin/articles/activity-dashboard/
- /enterprise/admin/installation/activity-dashboard
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
The Activity dashboard provides weekly, monthly, and yearly graphs of the number of:
diff --git a/content/admin/user-management/adding-people-to-teams.md b/content/admin/user-management/adding-people-to-teams.md
index 0a94dea0aa..cae2ec54c9 100644
--- a/content/admin/user-management/adding-people-to-teams.md
+++ b/content/admin/user-management/adding-people-to-teams.md
@@ -8,6 +8,8 @@ redirect_from:
intro: 'Once a team has been created, organization admins can add users from {% data variables.product.product_location %} to the team and determine which repositories they have access to.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Each team has its own individually defined [access permissions for repositories owned by your organization](/articles/permission-levels-for-an-organization).
diff --git a/content/admin/user-management/audit-logging.md b/content/admin/user-management/audit-logging.md
index 8a8da98e14..d4eb94ca04 100644
--- a/content/admin/user-management/audit-logging.md
+++ b/content/admin/user-management/audit-logging.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
For a full list, see "[Audited actions](/admin/user-management/audited-actions)." For more information on finding a particular action, see "[Searching the audit log](/admin/user-management/searching-the-audit-log)."
@@ -38,4 +40,4 @@ This example shows that commits were pushed to a repository.
```
Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" }
```
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/admin/user-management/audited-actions.md b/content/admin/user-management/audited-actions.md
index 57ed82a230..eaf820e04b 100644
--- a/content/admin/user-management/audited-actions.md
+++ b/content/admin/user-management/audited-actions.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
#### Authentication
diff --git a/content/admin/user-management/auditing-ssh-keys.md b/content/admin/user-management/auditing-ssh-keys.md
index fca0dbe5be..fa8aee9730 100644
--- a/content/admin/user-management/auditing-ssh-keys.md
+++ b/content/admin/user-management/auditing-ssh-keys.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
Once initiated, the audit disables all existing SSH keys and forces users to approve or reject them before they're able to clone, pull, or push to any repositories. An audit is useful in situations where an employee or contractor leaves the company and you need to ensure that all keys are verified.
diff --git a/content/admin/user-management/auditing-users-across-your-enterprise.md b/content/admin/user-management/auditing-users-across-your-enterprise.md
index 015fe8c7a2..d644c7cbeb 100644
--- a/content/admin/user-management/auditing-users-across-your-enterprise.md
+++ b/content/admin/user-management/auditing-users-across-your-enterprise.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Accessing the audit log
diff --git a/content/admin/user-management/best-practices-for-user-security.md b/content/admin/user-management/best-practices-for-user-security.md
index beae6174be..a0de18848f 100644
--- a/content/admin/user-management/best-practices-for-user-security.md
+++ b/content/admin/user-management/best-practices-for-user-security.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if enterpriseServerVersions contains currentVersion %}
diff --git a/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md b/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md
index e51686cb1f..bd22261272 100644
--- a/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md
+++ b/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md
@@ -15,6 +15,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### About {% data variables.large_files.product_name_long %}
diff --git a/content/admin/user-management/configuring-visibility-for-organization-membership.md b/content/admin/user-management/configuring-visibility-for-organization-membership.md
index 6551ad31f8..4b051cbd69 100644
--- a/content/admin/user-management/configuring-visibility-for-organization-membership.md
+++ b/content/admin/user-management/configuring-visibility-for-organization-membership.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% if enterpriseServerVersions contains currentVersion %}
diff --git a/content/admin/user-management/continuous-integration-using-jenkins.md b/content/admin/user-management/continuous-integration-using-jenkins.md
index 8f1ebe6bda..74cc0fc964 100644
--- a/content/admin/user-management/continuous-integration-using-jenkins.md
+++ b/content/admin/user-management/continuous-integration-using-jenkins.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/user-management/continuous-integration-using-jenkins
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Requirements
diff --git a/content/admin/user-management/creating-teams.md b/content/admin/user-management/creating-teams.md
index 96c25bbb5a..73de830082 100644
--- a/content/admin/user-management/creating-teams.md
+++ b/content/admin/user-management/creating-teams.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/user-management/creating-teams
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Teams are central to many of {% data variables.product.prodname_dotcom %}'s collaborative features, such as team @mentions to notify appropriate parties that you'd like to request their input or attention. For more information, see "[Permission levels for an organization repository](/enterprise/{{ currentVersion }}/user/articles/repository-permission-levels-for-an-organization/)".
diff --git a/content/admin/user-management/customizing-user-messages-for-your-enterprise.md b/content/admin/user-management/customizing-user-messages-for-your-enterprise.md
index 8d20c8a7ad..fb040c543b 100644
--- a/content/admin/user-management/customizing-user-messages-for-your-enterprise.md
+++ b/content/admin/user-management/customizing-user-messages-for-your-enterprise.md
@@ -8,6 +8,8 @@ intro: 'You can create custom messages that users will see on {% data variables.
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### About user messages
diff --git a/content/admin/user-management/disabling-git-ssh-access-on-your-enterprise.md b/content/admin/user-management/disabling-git-ssh-access-on-your-enterprise.md
index 1578faba94..ed0284421e 100644
--- a/content/admin/user-management/disabling-git-ssh-access-on-your-enterprise.md
+++ b/content/admin/user-management/disabling-git-ssh-access-on-your-enterprise.md
@@ -13,10 +13,12 @@ redirect_from:
- /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server
- /enterprise/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server
- /admin/user-management/disabling-git-ssh-access-on-github-enterprise-server
-intro: 'You can prevent people from using Git over SSH for certain or all repositories on your enterprise.'
+intro: You can prevent people from using Git over SSH for certain or all repositories on your enterprise.
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Disabling Git SSH access to a specific repository
diff --git a/content/admin/user-management/exporting-migration-data-from-githubcom.md b/content/admin/user-management/exporting-migration-data-from-githubcom.md
index 7856792cb0..6112f4c241 100644
--- a/content/admin/user-management/exporting-migration-data-from-githubcom.md
+++ b/content/admin/user-management/exporting-migration-data-from-githubcom.md
@@ -11,6 +11,8 @@ redirect_from:
- /enterprise/admin/user-management/exporting-migration-data-from-githubcom
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Preparing the source organization on {% data variables.product.prodname_dotcom %}
diff --git a/content/admin/user-management/exporting-migration-data-from-your-enterprise.md b/content/admin/user-management/exporting-migration-data-from-your-enterprise.md
index da606dbe91..a777e740e3 100644
--- a/content/admin/user-management/exporting-migration-data-from-your-enterprise.md
+++ b/content/admin/user-management/exporting-migration-data-from-your-enterprise.md
@@ -11,6 +11,8 @@ redirect_from:
- /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Preparing the {% data variables.product.prodname_ghe_server %} source instance
diff --git a/content/admin/user-management/importing-data-from-third-party-version-control-systems.md b/content/admin/user-management/importing-data-from-third-party-version-control-systems.md
index 8a81872d82..4fce02539d 100644
--- a/content/admin/user-management/importing-data-from-third-party-version-control-systems.md
+++ b/content/admin/user-management/importing-data-from-third-party-version-control-systems.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/user-management/importing-data-from-third-party-version-control-systems
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Importing projects from Mercurial
diff --git a/content/admin/user-management/index.md b/content/admin/user-management/index.md
index 73f0672568..6bbed26d46 100644
--- a/content/admin/user-management/index.md
+++ b/content/admin/user-management/index.md
@@ -11,6 +11,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/user-management/log-forwarding.md b/content/admin/user-management/log-forwarding.md
index 00ad4741f3..c30299376f 100644
--- a/content/admin/user-management/log-forwarding.md
+++ b/content/admin/user-management/log-forwarding.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
Any log collection system that supports syslog-style log streams is supported (e.g., [Logstash](http://logstash.net/) and [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)).
diff --git a/content/admin/user-management/managing-dormant-users.md b/content/admin/user-management/managing-dormant-users.md
index 9aaaccfb90..99c8980a2c 100644
--- a/content/admin/user-management/managing-dormant-users.md
+++ b/content/admin/user-management/managing-dormant-users.md
@@ -5,10 +5,12 @@ redirect_from:
- /enterprise/admin/articles/viewing-dormant-users/
- /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/
- /enterprise/admin/user-management/managing-dormant-users
-intro: A user account is considered to be dormant if it has not been active for at least a month.{% if enterpriseServerVersions contains currentVersion %} You may choose to suspend dormant users to free up user licenses.{% endif %}
+intro: 'A user account is considered to be dormant if it has not been active for at least a month.{% if enterpriseServerVersions contains currentVersion %} You may choose to suspend dormant users to free up user licenses.{% endif %}'
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
"Activity" includes, but is not limited to:
diff --git a/content/admin/user-management/managing-global-webhooks.md b/content/admin/user-management/managing-global-webhooks.md
index e34217f4ca..8dfcaa45e9 100644
--- a/content/admin/user-management/managing-global-webhooks.md
+++ b/content/admin/user-management/managing-global-webhooks.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### About global webhooks
diff --git a/content/admin/user-management/managing-organizations-in-your-enterprise.md b/content/admin/user-management/managing-organizations-in-your-enterprise.md
index 08415450a9..0fddb06a87 100644
--- a/content/admin/user-management/managing-organizations-in-your-enterprise.md
+++ b/content/admin/user-management/managing-organizations-in-your-enterprise.md
@@ -10,4 +10,7 @@ mapTopic: true
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/admin/user-management/managing-projects-using-jira.md b/content/admin/user-management/managing-projects-using-jira.md
index fb919a1769..c6ea376e22 100644
--- a/content/admin/user-management/managing-projects-using-jira.md
+++ b/content/admin/user-management/managing-projects-using-jira.md
@@ -9,6 +9,8 @@ redirect_from:
- /enterprise/admin/user-management/managing-projects-using-jira
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Connecting JIRA to a {% data variables.product.prodname_enterprise %} organization
diff --git a/content/admin/user-management/managing-repositories-in-your-enterprise.md b/content/admin/user-management/managing-repositories-in-your-enterprise.md
index 4da07ed3b7..bf4eb99cac 100644
--- a/content/admin/user-management/managing-repositories-in-your-enterprise.md
+++ b/content/admin/user-management/managing-repositories-in-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Managing repositories in your enterprise
-intro: 'You can manage the settings available to repository administrators in your enterprise.'
+intro: You can manage the settings available to repository administrators in your enterprise.
redirect_from:
- /enterprise/admin/user-management/repositories
- /enterprise/admin/user-management/managing-repositories-in-your-enterprise
@@ -8,5 +8,7 @@ mapTopic: true
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/user-management/managing-users-in-your-enterprise.md b/content/admin/user-management/managing-users-in-your-enterprise.md
index 63a373005f..f5ee73f94a 100644
--- a/content/admin/user-management/managing-users-in-your-enterprise.md
+++ b/content/admin/user-management/managing-users-in-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Managing users in your enterprise
-intro: 'You can audit user activity and manage user settings.'
+intro: You can audit user activity and manage user settings.
redirect_from:
- /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/
- /enterprise/admin/user-management/basic-account-settings
@@ -10,5 +10,7 @@ mapTopic: true
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md b/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md
index a3df463ac3..216d8e3aa4 100644
--- a/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md
+++ b/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md
@@ -9,5 +9,7 @@ redirect_from:
- /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/user-management/migrating-data-to-your-enterprise.md b/content/admin/user-management/migrating-data-to-your-enterprise.md
index e1a120ba63..47abddf047 100644
--- a/content/admin/user-management/migrating-data-to-your-enterprise.md
+++ b/content/admin/user-management/migrating-data-to-your-enterprise.md
@@ -13,6 +13,8 @@ redirect_from:
- /enterprise/admin/user-management/migrating-data-to-your-enterprise
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Applying the imported data on {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/user-management/migrating-to-internal-repositories.md b/content/admin/user-management/migrating-to-internal-repositories.md
index 509a9e1a11..c3abc3d40b 100644
--- a/content/admin/user-management/migrating-to-internal-repositories.md
+++ b/content/admin/user-management/migrating-to-internal-repositories.md
@@ -7,6 +7,8 @@ redirect_from:
permissions: Site administrators can migrate to internal repositories.
versions:
enterprise-server: '>=2.20'
+topics:
+ - enterprise
---
### About internal repositories
diff --git a/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/content/admin/user-management/monitoring-activity-in-your-enterprise.md
index a72fde4deb..4c8ae9bd38 100644
--- a/content/admin/user-management/monitoring-activity-in-your-enterprise.md
+++ b/content/admin/user-management/monitoring-activity-in-your-enterprise.md
@@ -7,5 +7,7 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md b/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md
index 20a81d080e..881f91d4b9 100644
--- a/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md
+++ b/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md
@@ -1,11 +1,13 @@
---
title: Placing a legal hold on a user or organization
-intro: 'You can place a legal hold on a user or organization to ensure that repositories they own cannot be permanently removed from your enterprise.'
+intro: You can place a legal hold on a user or organization to ensure that repositories they own cannot be permanently removed from your enterprise.
redirect_from:
- /enterprise/admin/user-management/placing-a-legal-hold-on-a-user-or-organization
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
Usually, if someone deletes a repository, it will be available on disk for 90 days and can be restored via the site admin dashboard. After 90 days the repository is purged and deleted forever. If you place a legal hold on a user or organization, repositories they own are available for restore indefinitely.
diff --git a/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md b/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md
index c6e85b46cc..b0b294e4ce 100644
--- a/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md
+++ b/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md
@@ -10,6 +10,8 @@ redirect_from:
- /enterprise/admin/user-management/preparing-to-migrate-data-to-your-enterprise
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
### Preparing the migrated data for import to {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/user-management/preventing-users-from-creating-organizations.md b/content/admin/user-management/preventing-users-from-creating-organizations.md
index 1a1f09c776..41355830c4 100644
--- a/content/admin/user-management/preventing-users-from-creating-organizations.md
+++ b/content/admin/user-management/preventing-users-from-creating-organizations.md
@@ -4,10 +4,12 @@ redirect_from:
- /enterprise/admin/articles/preventing-users-from-creating-organizations/
- /enterprise/admin/hidden/preventing-users-from-creating-organizations/
- /enterprise/admin/user-management/preventing-users-from-creating-organizations
-intro: 'You can prevent users from creating organizations in your enterprise.'
+intro: You can prevent users from creating organizations in your enterprise.
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise-accounts.access-enterprise %}
diff --git a/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/content/admin/user-management/promoting-or-demoting-a-site-administrator.md
index 8370cad870..225c8efd4b 100644
--- a/content/admin/user-management/promoting-or-demoting-a-site-administrator.md
+++ b/content/admin/user-management/promoting-or-demoting-a-site-administrator.md
@@ -7,6 +7,8 @@ redirect_from:
intro: 'Site administrators can promote any normal user account to a site administrator, as well as demote other site administrators to regular users.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
{% tip %}
@@ -52,4 +54,4 @@ For information about promoting a user to an organization owner, see the `ghe-or
2. Run [ghe-user-demote](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-user-demote) with the username to demote.
```shell
$ ghe-user-demote username
- ```
\ No newline at end of file
+ ```
diff --git a/content/admin/user-management/rebuilding-contributions-data.md b/content/admin/user-management/rebuilding-contributions-data.md
index 12b6e32f28..8ad18007f0 100644
--- a/content/admin/user-management/rebuilding-contributions-data.md
+++ b/content/admin/user-management/rebuilding-contributions-data.md
@@ -6,6 +6,8 @@ redirect_from:
- /enterprise/admin/user-management/rebuilding-contributions-data
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Whenever a commit is pushed to {% data variables.product.prodname_enterprise %}, it is linked to a user account if they are both associated with the same email address. However, existing commits are *not* retroactively linked when a user registers a new email address or creates a new account.
diff --git a/content/admin/user-management/removing-users-from-teams-and-organizations.md b/content/admin/user-management/removing-users-from-teams-and-organizations.md
index 3887587f90..2d4d6eace6 100644
--- a/content/admin/user-management/removing-users-from-teams-and-organizations.md
+++ b/content/admin/user-management/removing-users-from-teams-and-organizations.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/user-management/removing-users-from-teams-and-organizations
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
Only owners or team admins can remove organization members. When a user is removed from a team or organization, their issues, pull requests, and comments in the organization's repositories remain intact and are still attributed to the user.
diff --git a/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md b/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md
index 32cff3f262..a60123ce08 100644
--- a/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md
+++ b/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md
@@ -5,6 +5,8 @@ redirect_from:
- /enterprise/admin/user-management/requiring-two-factor-authentication-for-an-organization
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
When using LDAP or built-in authentication, two-factor authentication is supported on {% data variables.product.product_location %}. Organization administrators can require members to have two-factor authentication enabled.
diff --git a/content/admin/user-management/searching-the-audit-log.md b/content/admin/user-management/searching-the-audit-log.md
index 9495d0dc5c..aa9caf2db5 100644
--- a/content/admin/user-management/searching-the-audit-log.md
+++ b/content/admin/user-management/searching-the-audit-log.md
@@ -1,6 +1,6 @@
---
title: Searching the audit log
-intro: 'Site administrators can search an extensive list of audited actions on the enterprise.'
+intro: Site administrators can search an extensive list of audited actions on the enterprise.
redirect_from:
- /enterprise/admin/articles/searching-the-audit-log/
- /enterprise/admin/installation/searching-the-audit-log
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Search query syntax
diff --git a/content/admin/user-management/suspending-and-unsuspending-users.md b/content/admin/user-management/suspending-and-unsuspending-users.md
index ce82b3bb93..ba313b6765 100644
--- a/content/admin/user-management/suspending-and-unsuspending-users.md
+++ b/content/admin/user-management/suspending-and-unsuspending-users.md
@@ -10,6 +10,8 @@ redirect_from:
intro: 'If a user leaves or moves to a different part of the company, you should remove or modify their ability to access {% data variables.product.product_location %}.'
versions:
enterprise-server: '*'
+topics:
+ - enterprise
---
If employees leave the company, you can suspend their {% data variables.product.prodname_ghe_server %} accounts to open up user licenses in your {% data variables.product.prodname_enterprise %} license while preserving the issues, comments, repositories, gists, and other data they created. Suspended users cannot sign into your instance, nor can they push or pull code.
@@ -92,4 +94,4 @@ You can create a custom message that suspended users will see when attempting to
```
### Further reading
-- "[Suspend a user](/rest/reference/enterprise-admin#suspend-a-user)"
\ No newline at end of file
+- "[Suspend a user](/rest/reference/enterprise-admin#suspend-a-user)"
diff --git a/content/admin/user-management/troubleshooting-service-hooks.md b/content/admin/user-management/troubleshooting-service-hooks.md
index 3ae71bf810..f7e8ea77c0 100644
--- a/content/admin/user-management/troubleshooting-service-hooks.md
+++ b/content/admin/user-management/troubleshooting-service-hooks.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Getting information on deliveries
diff --git a/content/admin/user-management/viewing-push-logs.md b/content/admin/user-management/viewing-push-logs.md
index 19fb572493..3481540a90 100644
--- a/content/admin/user-management/viewing-push-logs.md
+++ b/content/admin/user-management/viewing-push-logs.md
@@ -1,6 +1,6 @@
---
title: Viewing push logs
-intro: 'Site administrators can view a list of Git push operations for any repository on the enterprise.'
+intro: Site administrators can view a list of Git push operations for any repository on the enterprise.
redirect_from:
- /enterprise/admin/articles/viewing-push-logs/
- /enterprise/admin/installation/viewing-push-logs
@@ -8,6 +8,8 @@ redirect_from:
versions:
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
Push log entries show:
@@ -38,4 +40,4 @@ Push log entries show:
```shell
ghe-repo owner/repository -c "less audit_log"
```
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/developers/apps/about-apps.md b/content/developers/apps/about-apps.md
index fff85efbab..e1c19c1da5 100644
--- a/content/developers/apps/about-apps.md
+++ b/content/developers/apps/about-apps.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
Apps on {% data variables.product.prodname_dotcom %} allow you to automate and improve your workflow. You can build apps to improve your workflow.{% if currentVersion == "free-pro-team@latest" %} You can also share or sell apps in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). To learn how to list an app on {% data variables.product.prodname_marketplace %}, see "[Getting started with GitHub Marketplace](/marketplace/getting-started/)."{% endif %}
diff --git a/content/developers/apps/activating-optional-features-for-apps.md b/content/developers/apps/activating-optional-features-for-apps.md
index ef5f534d5b..79ef3adf87 100644
--- a/content/developers/apps/activating-optional-features-for-apps.md
+++ b/content/developers/apps/activating-optional-features-for-apps.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
github-ae: '*'
enterprise-server: '>=2.22'
+topics:
+ - github apps
---
{% warning %}
diff --git a/content/developers/apps/authenticating-with-github-apps.md b/content/developers/apps/authenticating-with-github-apps.md
index 45b446f810..46ab929b32 100644
--- a/content/developers/apps/authenticating-with-github-apps.md
+++ b/content/developers/apps/authenticating-with-github-apps.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %}
@@ -77,8 +79,8 @@ private_key = OpenSSL::PKey::RSA.new(private_pem)
# Generate the JWT
payload = {
- # issued at time
- iat: Time.now.to_i,
+ # issued at time, 60 seconds in the past to allow for clock drift
+ iat: Time.now.to_i - 60,
# JWT expiration time (10 minute maximum)
exp: Time.now.to_i + (10 * 60),
# {% data variables.product.prodname_github_app %}'s identifier
diff --git a/content/developers/apps/authorizing-oauth-apps.md b/content/developers/apps/authorizing-oauth-apps.md
index 4a9ab098cc..cbf94e9bae 100644
--- a/content/developers/apps/authorizing-oauth-apps.md
+++ b/content/developers/apps/authorizing-oauth-apps.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% data variables.product.product_name %}'s OAuth implementation supports the standard [authorization code grant type](https://tools.ietf.org/html/rfc6749#section-4.1){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} and the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628) for apps that don't have access to a web browser{% endif %}.
diff --git a/content/developers/apps/building-github-apps.md b/content/developers/apps/building-github-apps.md
index 91bb4479af..8c79f00995 100644
--- a/content/developers/apps/building-github-apps.md
+++ b/content/developers/apps/building-github-apps.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/building-oauth-apps.md b/content/developers/apps/building-oauth-apps.md
index ccedbd6267..16fbbbf523 100644
--- a/content/developers/apps/building-oauth-apps.md
+++ b/content/developers/apps/building-oauth-apps.md
@@ -9,5 +9,6 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
-
diff --git a/content/developers/apps/creating-a-custom-badge-for-your-github-app.md b/content/developers/apps/creating-a-custom-badge-for-your-github-app.md
index c39b720c26..2f26017f1c 100644
--- a/content/developers/apps/creating-a-custom-badge-for-your-github-app.md
+++ b/content/developers/apps/creating-a-custom-badge-for-your-github-app.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
By default, a new GitHub App will have an automatically generated [identicon](https://github.com/blog/1586-identicons).
diff --git a/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md
index 9945833d00..f39207563e 100644
--- a/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md
+++ b/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons).
diff --git a/content/developers/apps/creating-a-github-app-from-a-manifest.md b/content/developers/apps/creating-a-github-app-from-a-manifest.md
index 7c18a8b460..22c65eacfa 100644
--- a/content/developers/apps/creating-a-github-app-from-a-manifest.md
+++ b/content/developers/apps/creating-a-github-app-from-a-manifest.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/creating-a-github-app-using-url-parameters.md b/content/developers/apps/creating-a-github-app-using-url-parameters.md
index 99d0f03a93..a4794039ea 100644
--- a/content/developers/apps/creating-a-github-app-using-url-parameters.md
+++ b/content/developers/apps/creating-a-github-app-using-url-parameters.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/creating-a-github-app.md b/content/developers/apps/creating-a-github-app.md
index cae49a410a..63b95c7eae 100644
--- a/content/developers/apps/creating-a-github-app.md
+++ b/content/developers/apps/creating-a-github-app.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% if currentVersion == "free-pro-team@latest" %}To learn how to use GitHub App Manifests, which allow people to create preconfigured GitHub Apps, see "[Creating GitHub Apps from a manifest](/apps/building-github-apps/creating-github-apps-from-a-manifest/)."{% endif %}
diff --git a/content/developers/apps/creating-an-oauth-app.md b/content/developers/apps/creating-an-oauth-app.md
index c885dc2134..0340b236ef 100644
--- a/content/developers/apps/creating-an-oauth-app.md
+++ b/content/developers/apps/creating-an-oauth-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/content/developers/apps/creating-ci-tests-with-the-checks-api.md
index e964e7b055..8d8bd1e520 100644
--- a/content/developers/apps/creating-ci-tests-with-the-checks-api.md
+++ b/content/developers/apps/creating-ci-tests-with-the-checks-api.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/deleting-a-github-app.md b/content/developers/apps/deleting-a-github-app.md
index 6c32b8f7f9..7c40c0b61d 100644
--- a/content/developers/apps/deleting-a-github-app.md
+++ b/content/developers/apps/deleting-a-github-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/deleting-an-oauth-app.md b/content/developers/apps/deleting-an-oauth-app.md
index cdf87e56e0..75eb74ad1a 100644
--- a/content/developers/apps/deleting-an-oauth-app.md
+++ b/content/developers/apps/deleting-an-oauth-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/content/developers/apps/differences-between-github-apps-and-oauth-apps.md
index 091642a8f7..c1c8b1c125 100644
--- a/content/developers/apps/differences-between-github-apps-and-oauth-apps.md
+++ b/content/developers/apps/differences-between-github-apps-and-oauth-apps.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
+ - oauth apps
---
### Who can install GitHub Apps and authorize OAuth Apps?
diff --git a/content/developers/apps/editing-a-github-apps-permissions.md b/content/developers/apps/editing-a-github-apps-permissions.md
index d57db219a1..62ec4ae5c0 100644
--- a/content/developers/apps/editing-a-github-apps-permissions.md
+++ b/content/developers/apps/editing-a-github-apps-permissions.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% note %}
diff --git a/content/developers/apps/getting-started-with-apps.md b/content/developers/apps/getting-started-with-apps.md
index d6bc3d7a0f..46aa599b97 100644
--- a/content/developers/apps/getting-started-with-apps.md
+++ b/content/developers/apps/getting-started-with-apps.md
@@ -6,5 +6,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/guides.md b/content/developers/apps/guides.md
index 1e90f02406..125c0f5c42 100644
--- a/content/developers/apps/guides.md
+++ b/content/developers/apps/guides.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
index 0c27bda883..6f235d3ca0 100644
--- a/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
+++ b/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/index.md b/content/developers/apps/index.md
index e384433f90..5dab758c53 100644
--- a/content/developers/apps/index.md
+++ b/content/developers/apps/index.md
@@ -13,6 +13,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% topic_link_in_list /getting-started-with-apps %}
diff --git a/content/developers/apps/installing-github-apps.md b/content/developers/apps/installing-github-apps.md
index c997ded78a..59215beea0 100644
--- a/content/developers/apps/installing-github-apps.md
+++ b/content/developers/apps/installing-github-apps.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% note %}
diff --git a/content/developers/apps/making-a-github-app-public-or-private.md b/content/developers/apps/making-a-github-app-public-or-private.md
index 036d3d589d..37f0bee15c 100644
--- a/content/developers/apps/making-a-github-app-public-or-private.md
+++ b/content/developers/apps/making-a-github-app-public-or-private.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
For authentication information, see "[Authenticating with GitHub Apps](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)."
diff --git a/content/developers/apps/managing-github-apps.md b/content/developers/apps/managing-github-apps.md
index fb3b9c3934..0bab3a14a5 100644
--- a/content/developers/apps/managing-github-apps.md
+++ b/content/developers/apps/managing-github-apps.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/managing-oauth-apps.md b/content/developers/apps/managing-oauth-apps.md
index e1bf769ded..18cb006f91 100644
--- a/content/developers/apps/managing-oauth-apps.md
+++ b/content/developers/apps/managing-oauth-apps.md
@@ -9,5 +9,6 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
-
diff --git a/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/content/developers/apps/migrating-oauth-apps-to-github-apps.md
index 21fbe532f2..eedbac7a4c 100644
--- a/content/developers/apps/migrating-oauth-apps-to-github-apps.md
+++ b/content/developers/apps/migrating-oauth-apps-to-github-apps.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/modifying-a-github-app.md b/content/developers/apps/modifying-a-github-app.md
index 47392e13f0..39278961f9 100644
--- a/content/developers/apps/modifying-a-github-app.md
+++ b/content/developers/apps/modifying-a-github-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/modifying-an-oauth-app.md b/content/developers/apps/modifying-an-oauth-app.md
index 73beec3337..7b15a86e19 100644
--- a/content/developers/apps/modifying-an-oauth-app.md
+++ b/content/developers/apps/modifying-an-oauth-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/rate-limits-for-github-apps.md b/content/developers/apps/rate-limits-for-github-apps.md
index 31607e2e14..2451916675 100644
--- a/content/developers/apps/rate-limits-for-github-apps.md
+++ b/content/developers/apps/rate-limits-for-github-apps.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
### Server-to-server requests
diff --git a/content/developers/apps/refreshing-user-to-server-access-tokens.md b/content/developers/apps/refreshing-user-to-server-access-tokens.md
index 3a21601f34..ca66b82b31 100644
--- a/content/developers/apps/refreshing-user-to-server-access-tokens.md
+++ b/content/developers/apps/refreshing-user-to-server-access-tokens.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/scopes-for-oauth-apps.md b/content/developers/apps/scopes-for-oauth-apps.md
index 366efeb18b..db6e245649 100644
--- a/content/developers/apps/scopes-for-oauth-apps.md
+++ b/content/developers/apps/scopes-for-oauth-apps.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
When setting up an OAuth App on GitHub, requested scopes are displayed to the user on the authorization form.
diff --git a/content/developers/apps/setting-permissions-for-github-apps.md b/content/developers/apps/setting-permissions-for-github-apps.md
index 547f445758..4d9c1fb557 100644
--- a/content/developers/apps/setting-permissions-for-github-apps.md
+++ b/content/developers/apps/setting-permissions-for-github-apps.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
GitHub Apps don't have any permissions by default. When you create a GitHub App, you can select the permissions it needs to access end user data. Permissions can also be added and removed. For more information, see "[Editing a GitHub App's permissions](/apps/managing-github-apps/editing-a-github-app-s-permissions/)."
diff --git a/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md
index 3a35ecc6da..6e4d57a597 100644
--- a/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md
+++ b/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/apps/suspending-a-github-app-installation.md b/content/developers/apps/suspending-a-github-app-installation.md
index 8ec4ca2e06..a619a27810 100644
--- a/content/developers/apps/suspending-a-github-app-installation.md
+++ b/content/developers/apps/suspending-a-github-app-installation.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - github apps
---
### Suspending a GitHub App
diff --git a/content/developers/apps/transferring-ownership-of-a-github-app.md b/content/developers/apps/transferring-ownership-of-a-github-app.md
index 118908599d..0d9f093edf 100644
--- a/content/developers/apps/transferring-ownership-of-a-github-app.md
+++ b/content/developers/apps/transferring-ownership-of-a-github-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/transferring-ownership-of-an-oauth-app.md b/content/developers/apps/transferring-ownership-of-an-oauth-app.md
index 59d1b1adc3..023d8477dd 100644
--- a/content/developers/apps/transferring-ownership-of-an-oauth-app.md
+++ b/content/developers/apps/transferring-ownership-of-an-oauth-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% data reusables.user-settings.access_settings %}
diff --git a/content/developers/apps/troubleshooting-authorization-request-errors.md b/content/developers/apps/troubleshooting-authorization-request-errors.md
index 4620a4aa35..aed485cc2b 100644
--- a/content/developers/apps/troubleshooting-authorization-request-errors.md
+++ b/content/developers/apps/troubleshooting-authorization-request-errors.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
### Application suspended
diff --git a/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md b/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md
index c6b54ed2b2..af14d42307 100644
--- a/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md
+++ b/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - oauth apps
---
{% note %}
diff --git a/content/developers/apps/using-content-attachments.md b/content/developers/apps/using-content-attachments.md
index ed9e9fde07..8fc9225435 100644
--- a/content/developers/apps/using-content-attachments.md
+++ b/content/developers/apps/using-content-attachments.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
{% data reusables.pre-release-program.content-attachments-public-beta %}
diff --git a/content/developers/apps/using-the-github-api-in-your-app.md b/content/developers/apps/using-the-github-api-in-your-app.md
index ebd8e6ed71..d128429499 100644
--- a/content/developers/apps/using-the-github-api-in-your-app.md
+++ b/content/developers/apps/using-the-github-api-in-your-app.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github apps
---
diff --git a/content/developers/github-marketplace/about-github-marketplace.md b/content/developers/github-marketplace/about-github-marketplace.md
index a5566fb012..cc3ca5561e 100644
--- a/content/developers/github-marketplace/about-github-marketplace.md
+++ b/content/developers/github-marketplace/about-github-marketplace.md
@@ -6,6 +6,8 @@ redirect_from:
- /marketplace/getting-started
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) connects you to developers who want to extend and improve their {% data variables.product.prodname_dotcom %} workflows. You can list free and paid tools for developers to use in {% data variables.product.prodname_marketplace %}. {% data variables.product.prodname_marketplace %} offers developers two types of tools: {% data variables.product.prodname_actions %} and Apps, and each tool requires different steps for adding it to {% data variables.product.prodname_marketplace %}.
diff --git a/content/developers/github-marketplace/applying-for-publisher-verification-for-your-organization.md b/content/developers/github-marketplace/applying-for-publisher-verification-for-your-organization.md
index 8919eee16e..f6c6257f9d 100644
--- a/content/developers/github-marketplace/applying-for-publisher-verification-for-your-organization.md
+++ b/content/developers/github-marketplace/applying-for-publisher-verification-for-your-organization.md
@@ -3,6 +3,8 @@ title: Applying for publisher verification for your organization
intro: 'To offer paid plans for your app or to include a marketplace badge in your app listing, you must complete the publisher verification process for your organization.'
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
Publisher verification ensures that {% data variables.product.prodname_dotcom %} has a way to contact you, that you've enabled two-factor authentication for your organization, and that your organization's domain has been verified.
diff --git a/content/developers/github-marketplace/billing-customers.md b/content/developers/github-marketplace/billing-customers.md
index ed6701d671..2e578e1458 100644
--- a/content/developers/github-marketplace/billing-customers.md
+++ b/content/developers/github-marketplace/billing-customers.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/selling-your-app/billing-customers-in-github-marketplace
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/configuring-a-webhook-to-notify-you-of-plan-changes.md b/content/developers/github-marketplace/configuring-a-webhook-to-notify-you-of-plan-changes.md
index 6ed97feecd..00e34854f1 100644
--- a/content/developers/github-marketplace/configuring-a-webhook-to-notify-you-of-plan-changes.md
+++ b/content/developers/github-marketplace/configuring-a-webhook-to-notify-you-of-plan-changes.md
@@ -9,6 +9,8 @@ redirect_from:
- /marketplace/listing-on-github-marketplace/configuring-the-github-marketplace-webhook
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/content/developers/github-marketplace/creating-apps-for-github-marketplace.md
index 342754e94d..1db26ad8f2 100644
--- a/content/developers/github-marketplace/creating-apps-for-github-marketplace.md
+++ b/content/developers/github-marketplace/creating-apps-for-github-marketplace.md
@@ -4,5 +4,7 @@ intro: 'You can list free and paid tools for developers to use in {% data variab
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md b/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md
index 4107fa4427..b739663a7d 100644
--- a/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md
+++ b/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md
@@ -1,9 +1,11 @@
---
title: Customer experience best practices for apps
-intro: 'Guidelines for creating an app that will be easy to use and understand.'
+intro: Guidelines for creating an app that will be easy to use and understand.
shortTitle: Customer experience best practice
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
If you follow these best practices it will help you to provide a good customer experience.
diff --git a/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/content/developers/github-marketplace/drafting-a-listing-for-your-app.md
index c495928b43..85fcb55cc2 100644
--- a/content/developers/github-marketplace/drafting-a-listing-for-your-app.md
+++ b/content/developers/github-marketplace/drafting-a-listing-for-your-app.md
@@ -14,6 +14,8 @@ redirect_from:
- /marketplace/listing-on-github-marketplace/creating-a-draft-github-marketplace-listing
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md b/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md
index 94b29c63ff..0809b8196c 100644
--- a/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md
+++ b/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md
@@ -8,6 +8,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/handling-plan-cancellations.md b/content/developers/github-marketplace/handling-plan-cancellations.md
index ed287efb5e..2334e0fe9a 100644
--- a/content/developers/github-marketplace/handling-plan-cancellations.md
+++ b/content/developers/github-marketplace/handling-plan-cancellations.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/cancelling-plans
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/handling-plan-changes.md b/content/developers/github-marketplace/handling-plan-changes.md
index 7fb64dd96c..a567ed24d9 100644
--- a/content/developers/github-marketplace/handling-plan-changes.md
+++ b/content/developers/github-marketplace/handling-plan-changes.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/upgrading-and-downgrading-plans
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/index.md b/content/developers/github-marketplace/index.md
index 9d018cfe81..96571894ae 100644
--- a/content/developers/github-marketplace/index.md
+++ b/content/developers/github-marketplace/index.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
{% topic_link_in_list /github-marketplace-overview %}
diff --git a/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md b/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md
index 58924a15d0..cfe604c53e 100644
--- a/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md
+++ b/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md
@@ -13,5 +13,7 @@ redirect_from:
- /marketplace/listing-on-github-marketplace
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md
index 8e76577810..33e7aeeccc 100644
--- a/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md
+++ b/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md
@@ -6,6 +6,8 @@ redirect_from:
- /marketplace/selling-your-app/github-marketplace-pricing-plans
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/content/developers/github-marketplace/receiving-payment-for-app-purchases.md
index 0264e77e2e..85bb104042 100644
--- a/content/developers/github-marketplace/receiving-payment-for-app-purchases.md
+++ b/content/developers/github-marketplace/receiving-payment-for-app-purchases.md
@@ -9,6 +9,8 @@ redirect_from:
- /marketplace/selling-your-app/receiving-payment-for-github-marketplace-listings
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/requirements-for-listing-an-app.md b/content/developers/github-marketplace/requirements-for-listing-an-app.md
index 3a2a3d1be3..05213fa2b8 100644
--- a/content/developers/github-marketplace/requirements-for-listing-an-app.md
+++ b/content/developers/github-marketplace/requirements-for-listing-an-app.md
@@ -10,6 +10,8 @@ redirect_from:
- /marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md b/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md
index db3482b992..09ae762f88 100644
--- a/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md
+++ b/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/github-marketplace-rest-api-endpoints
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/security-best-practices-for-apps.md b/content/developers/github-marketplace/security-best-practices-for-apps.md
index fac3d2fcf6..b8be78bbfa 100644
--- a/content/developers/github-marketplace/security-best-practices-for-apps.md
+++ b/content/developers/github-marketplace/security-best-practices-for-apps.md
@@ -8,6 +8,8 @@ redirect_from:
shortTitle: Security best practice
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
If you follow these best practices it will help you to provide a secure user experience.
diff --git a/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md b/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md
index e468593f58..5b643723ff 100644
--- a/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md
+++ b/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md
@@ -11,5 +11,7 @@ redirect_from:
- /marketplace/selling-your-app
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md b/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md
index 14fb5e0e67..7b7f3014d4 100644
--- a/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md
+++ b/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md
@@ -15,6 +15,8 @@ redirect_from:
- /marketplace/listing-on-github-marketplace/setting-a-github-marketplace-listing-s-pricing-plan
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
### About setting pricing plans
diff --git a/content/developers/github-marketplace/submitting-your-listing-for-publication.md b/content/developers/github-marketplace/submitting-your-listing-for-publication.md
index f56182b6ba..eba474e22e 100644
--- a/content/developers/github-marketplace/submitting-your-listing-for-publication.md
+++ b/content/developers/github-marketplace/submitting-your-listing-for-publication.md
@@ -6,6 +6,8 @@ redirect_from:
- /developers/github-marketplace/submitting-your-listing-for-review
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
Once your app listing meets the {% data variables.product.prodname_marketplace %} requirements, you can submit your app. For an overview of the app listing requirements, see "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)."
diff --git a/content/developers/github-marketplace/testing-your-app.md b/content/developers/github-marketplace/testing-your-app.md
index 577b6d624a..e587a94908 100644
--- a/content/developers/github-marketplace/testing-your-app.md
+++ b/content/developers/github-marketplace/testing-your-app.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md b/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md
index 79b8ccfe43..6846363051 100644
--- a/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md
+++ b/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md
@@ -8,5 +8,7 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/content/developers/github-marketplace/viewing-metrics-for-your-listing.md
index de49180466..3621b2e7b8 100644
--- a/content/developers/github-marketplace/viewing-metrics-for-your-listing.md
+++ b/content/developers/github-marketplace/viewing-metrics-for-your-listing.md
@@ -8,6 +8,8 @@ redirect_from:
- /marketplace/github-marketplace-insights
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/content/developers/github-marketplace/viewing-transactions-for-your-listing.md
index b0c801eaa0..60f69eafb4 100644
--- a/content/developers/github-marketplace/viewing-transactions-for-your-listing.md
+++ b/content/developers/github-marketplace/viewing-transactions-for-your-listing.md
@@ -5,6 +5,8 @@ redirect_from:
- /marketplace/github-marketplace-transactions
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md
index 96594bbc61..71772c127c 100644
--- a/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md
+++ b/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md
@@ -7,6 +7,8 @@ redirect_from:
- /marketplace/integrating-with-the-github-marketplace-api/github-marketplace-webhook-events
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/github-marketplace/writing-a-listing-description-for-your-app.md b/content/developers/github-marketplace/writing-a-listing-description-for-your-app.md
index 7dabc220bb..50544a871f 100644
--- a/content/developers/github-marketplace/writing-a-listing-description-for-your-app.md
+++ b/content/developers/github-marketplace/writing-a-listing-description-for-your-app.md
@@ -12,6 +12,8 @@ redirect_from:
- /marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions
versions:
free-pro-team: '*'
+topics:
+ - marketplace
---
diff --git a/content/developers/overview/about-githubs-apis.md b/content/developers/overview/about-githubs-apis.md
index e60baa72e3..7141a1ac74 100644
--- a/content/developers/overview/about-githubs-apis.md
+++ b/content/developers/overview/about-githubs-apis.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
There are two stable versions of the GitHub API: the [REST API](/rest) and the [GraphQL API](/graphql). When using the REST API, we encourage you to [request v3 via the `Accept` header](/v3/media/#request-specific-version). For information on using the GraphQL API, see the [v4 docs](/graphql).
diff --git a/content/developers/overview/github-developer-program.md b/content/developers/overview/github-developer-program.md
index 343241fd6f..947b290ce3 100644
--- a/content/developers/overview/github-developer-program.md
+++ b/content/developers/overview/github-developer-program.md
@@ -5,6 +5,8 @@ redirect_from:
- /program
versions:
free-pro-team: '*'
+topics:
+ - api
---
Building an application that integrates with GitHub? Register for our Developer Program! The possibilities are endless, and you enjoy the kudos. [Register now](https://github.com/developer/register)
diff --git a/content/developers/overview/managing-deploy-keys.md b/content/developers/overview/managing-deploy-keys.md
index d97cec6391..ad419e8717 100644
--- a/content/developers/overview/managing-deploy-keys.md
+++ b/content/developers/overview/managing-deploy-keys.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/developers/overview/replacing-github-services.md b/content/developers/overview/replacing-github-services.md
index 878a316bd5..05f75c5079 100644
--- a/content/developers/overview/replacing-github-services.md
+++ b/content/developers/overview/replacing-github-services.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - api
---
diff --git a/content/developers/overview/secret-scanning.md b/content/developers/overview/secret-scanning.md
index 278f89e672..9c2d39bf94 100644
--- a/content/developers/overview/secret-scanning.md
+++ b/content/developers/overview/secret-scanning.md
@@ -7,6 +7,8 @@ redirect_from:
- /partnerships/secret-scanning
versions:
free-pro-team: '*'
+topics:
+ - api
---
{% data variables.product.prodname_dotcom %} scans repositories for known secret formats to prevent fraudulent use of credentials that were committed accidentally. {% data variables.product.prodname_secret_scanning_caps %} happens by default on public repositories, and can be enabled on private repositories by repository administrators or organization owners. As a service provider, you can partner with {% data variables.product.prodname_dotcom %} so that your secret formats are included in our {% data variables.product.prodname_secret_scanning %}.
diff --git a/content/developers/overview/using-ssh-agent-forwarding.md b/content/developers/overview/using-ssh-agent-forwarding.md
index 81b5ffbd5f..dfa6e0efc4 100644
--- a/content/developers/overview/using-ssh-agent-forwarding.md
+++ b/content/developers/overview/using-ssh-agent-forwarding.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/developers/overview/viewing-deployment-history.md b/content/developers/overview/viewing-deployment-history.md
index 05d8099b78..5d9f721581 100644
--- a/content/developers/overview/viewing-deployment-history.md
+++ b/content/developers/overview/viewing-deployment-history.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% data reusables.actions.environments-beta %}
diff --git a/content/developers/webhooks-and-events/about-webhooks.md b/content/developers/webhooks-and-events/about-webhooks.md
index 3123eb3183..1c4708f577 100644
--- a/content/developers/webhooks-and-events/about-webhooks.md
+++ b/content/developers/webhooks-and-events/about-webhooks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/developers/webhooks-and-events/configuring-your-server-to-receive-payloads.md b/content/developers/webhooks-and-events/configuring-your-server-to-receive-payloads.md
index c4787dcc97..42464d48ef 100644
--- a/content/developers/webhooks-and-events/configuring-your-server-to-receive-payloads.md
+++ b/content/developers/webhooks-and-events/configuring-your-server-to-receive-payloads.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/developers/webhooks-and-events/creating-webhooks.md b/content/developers/webhooks-and-events/creating-webhooks.md
index 17d3ac7a24..ab6e95e7bb 100644
--- a/content/developers/webhooks-and-events/creating-webhooks.md
+++ b/content/developers/webhooks-and-events/creating-webhooks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/developers/webhooks-and-events/events.md b/content/developers/webhooks-and-events/events.md
index 6fead511c2..761e6b2472 100644
--- a/content/developers/webhooks-and-events/events.md
+++ b/content/developers/webhooks-and-events/events.md
@@ -6,5 +6,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - events
---
diff --git a/content/developers/webhooks-and-events/github-event-types.md b/content/developers/webhooks-and-events/github-event-types.md
index 72098b42fa..74579398db 100644
--- a/content/developers/webhooks-and-events/github-event-types.md
+++ b/content/developers/webhooks-and-events/github-event-types.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - events
---
diff --git a/content/developers/webhooks-and-events/index.md b/content/developers/webhooks-and-events/index.md
index 8fe5ba3cd8..e433da0403 100644
--- a/content/developers/webhooks-and-events/index.md
+++ b/content/developers/webhooks-and-events/index.md
@@ -5,6 +5,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
+ - events
---
### Table of Contents
diff --git a/content/developers/webhooks-and-events/issue-event-types.md b/content/developers/webhooks-and-events/issue-event-types.md
index 9da44234bd..41380543d1 100644
--- a/content/developers/webhooks-and-events/issue-event-types.md
+++ b/content/developers/webhooks-and-events/issue-event-types.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - events
---
diff --git a/content/developers/webhooks-and-events/securing-your-webhooks.md b/content/developers/webhooks-and-events/securing-your-webhooks.md
index c32343b777..cfdf4c9a1e 100644
--- a/content/developers/webhooks-and-events/securing-your-webhooks.md
+++ b/content/developers/webhooks-and-events/securing-your-webhooks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/developers/webhooks-and-events/testing-webhooks.md b/content/developers/webhooks-and-events/testing-webhooks.md
index 3735773363..ba40fe2cb4 100644
--- a/content/developers/webhooks-and-events/testing-webhooks.md
+++ b/content/developers/webhooks-and-events/testing-webhooks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/content/developers/webhooks-and-events/webhook-events-and-payloads.md
index f55db93d4d..1ceeba1939 100644
--- a/content/developers/webhooks-and-events/webhook-events-and-payloads.md
+++ b/content/developers/webhooks-and-events/webhook-events-and-payloads.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
@@ -1335,9 +1337,8 @@ When a {% data variables.product.prodname_actions %} workflow run is requested o
#### Webhook payload object
-Key | Type | Description
-----|------|-------------
-`action` | `string` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event.
+{% data reusables.webhooks.workflow_run_properties %}
+{% data reusables.webhooks.workflow_desc %}
{% data reusables.webhooks.org_desc %}
{% data reusables.webhooks.repo_desc %}
{% data reusables.webhooks.sender_desc %}
diff --git a/content/developers/webhooks-and-events/webhooks.md b/content/developers/webhooks-and-events/webhooks.md
index ce66413490..9a1347c894 100644
--- a/content/developers/webhooks-and-events/webhooks.md
+++ b/content/developers/webhooks-and-events/webhooks.md
@@ -6,5 +6,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - webhooks
---
diff --git a/content/discussions/guides/best-practices-for-community-conversations-on-github.md b/content/discussions/guides/best-practices-for-community-conversations-on-github.md
index e4cc2321b6..6631fd4d3c 100644
--- a/content/discussions/guides/best-practices-for-community-conversations-on-github.md
+++ b/content/discussions/guides/best-practices-for-community-conversations-on-github.md
@@ -29,7 +29,7 @@ You can use {% data variables.product.prodname_discussions %} to discuss big pic
Issues are useful for discussing specific details of a project such as bug reports and planned improvements. For more information, see "[About issues](/articles/about-issues)." Pull requests allow you to comment directly on proposed changes. For more information, see "[About pull requests](/articles/about-pull-requests)" and "[Commenting on a pull request](/articles/commenting-on-a-pull-request)."
-{% data reusables.organizations.team-discussions-purpose %} For more information, see "[About team discussions](/articles/about-team-discussions)."
+{% data reusables.organizations.team-discussions-purpose %} For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
### Following contributing guidelines
diff --git a/content/github/administering-a-repository/about-dependabot-version-updates.md b/content/github/administering-a-repository/about-dependabot-version-updates.md
index 70156ab2c9..d96a8719f3 100644
--- a/content/github/administering-a-repository/about-dependabot-version-updates.md
+++ b/content/github/administering-a-repository/about-dependabot-version-updates.md
@@ -5,9 +5,10 @@ redirect_from:
- /github/administering-a-repository/about-dependabot
- /github/administering-a-repository/about-github-dependabot
- /github/administering-a-repository/about-github-dependabot-version-updates
-
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md
index 792bfec4bc..88b8fbb6d7 100644
--- a/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md
+++ b/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.notifications.outbound_email_tip %}
diff --git a/content/github/administering-a-repository/about-merge-methods-on-github.md b/content/github/administering-a-repository/about-merge-methods-on-github.md
index d8928317a6..6533a3ec45 100644
--- a/content/github/administering-a-repository/about-merge-methods-on-github.md
+++ b/content/github/administering-a-repository/about-merge-methods-on-github.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %} You can enforce one type of merge method, such as commit squashing or rebasing, by only enabling the desired method for your repository.
diff --git a/content/github/administering-a-repository/about-protected-branches.md b/content/github/administering-a-repository/about-protected-branches.md
index c842929a11..1dc9ce75c3 100644
--- a/content/github/administering-a-repository/about-protected-branches.md
+++ b/content/github/administering-a-repository/about-protected-branches.md
@@ -19,6 +19,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About branch protection rules
diff --git a/content/github/administering-a-repository/about-releases.md b/content/github/administering-a-repository/about-releases.md
index 81ade4c4b0..fc0699c303 100644
--- a/content/github/administering-a-repository/about-releases.md
+++ b/content/github/administering-a-repository/about-releases.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About releases
diff --git a/content/github/administering-a-repository/about-secret-scanning.md b/content/github/administering-a-repository/about-secret-scanning.md
index 8835b2c460..38696dfe50 100644
--- a/content/github/administering-a-repository/about-secret-scanning.md
+++ b/content/github/administering-a-repository/about-secret-scanning.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.secret-scanning.beta %}
diff --git a/content/github/administering-a-repository/about-securing-your-repository.md b/content/github/administering-a-repository/about-securing-your-repository.md
index e383cbb71e..a98f29f304 100644
--- a/content/github/administering-a-repository/about-securing-your-repository.md
+++ b/content/github/administering-a-repository/about-securing-your-repository.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
### Setting up your repository securely
diff --git a/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md b/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md
index a24e1145b9..10e4011e88 100644
--- a/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md
+++ b/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Query parameters are optional parts of a URL you can customize to share a specific web page view, such as search filter results, an issue template, or the release form page on {% data variables.product.prodname_dotcom %}. To create your own query parameters, you must match the key and value pair.
diff --git a/content/github/administering-a-repository/changing-the-default-branch.md b/content/github/administering-a-repository/changing-the-default-branch.md
index cefd27c271..f1f0f892bd 100644
--- a/content/github/administering-a-repository/changing-the-default-branch.md
+++ b/content/github/administering-a-repository/changing-the-default-branch.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /github/administering-a-repository/setting-the-default-branch
- /articles/setting-the-default-branch
+topics:
+ - repositories
---
### About changing the default branch
diff --git a/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/content/github/administering-a-repository/classifying-your-repository-with-topics.md
index a187c9313d..8918184c6b 100644
--- a/content/github/administering-a-repository/classifying-your-repository-with-topics.md
+++ b/content/github/administering-a-repository/classifying-your-repository-with-topics.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About topics
diff --git a/content/github/administering-a-repository/comparing-releases.md b/content/github/administering-a-repository/comparing-releases.md
index 7e57598c48..ae83a329db 100644
--- a/content/github/administering-a-repository/comparing-releases.md
+++ b/content/github/administering-a-repository/comparing-releases.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/content/github/administering-a-repository/configuration-options-for-dependency-updates.md
index a732e3244c..bae978220c 100644
--- a/content/github/administering-a-repository/configuration-options-for-dependency-updates.md
+++ b/content/github/administering-a-repository/configuration-options-for-dependency-updates.md
@@ -5,6 +5,8 @@ permissions: 'People with write permissions to a repository can configure {% dat
miniTocMaxHeadingLevel: 4
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md
index dafdd7d9e5..023771cbe1 100644
--- a/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md
+++ b/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services.
diff --git a/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md b/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md
index eb2944629f..2a8e4a235b 100644
--- a/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md
+++ b/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %}
diff --git a/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md b/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md
index 8a3a1cde8c..010fbbcb58 100644
--- a/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md
+++ b/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %}
diff --git a/content/github/administering-a-repository/configuring-pull-request-merges.md b/content/github/administering-a-repository/configuring-pull-request-merges.md
index f42c9d2a9a..4f05c5af5a 100644
--- a/content/github/administering-a-repository/configuring-pull-request-merges.md
+++ b/content/github/administering-a-repository/configuring-pull-request-merges.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/configuring-secret-scanning-for-your-repositories.md b/content/github/administering-a-repository/configuring-secret-scanning-for-your-repositories.md
index 27105cdd2f..1060d92009 100644
--- a/content/github/administering-a-repository/configuring-secret-scanning-for-your-repositories.md
+++ b/content/github/administering-a-repository/configuring-secret-scanning-for-your-repositories.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.secret-scanning.beta %}
diff --git a/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md
index 8c100e064b..309dca088f 100644
--- a/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md
+++ b/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.23'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.actions.about-artifact-log-retention %}
diff --git a/content/github/administering-a-repository/customizing-dependency-updates.md b/content/github/administering-a-repository/customizing-dependency-updates.md
index 95340f31d2..8d078b68fc 100644
--- a/content/github/administering-a-repository/customizing-dependency-updates.md
+++ b/content/github/administering-a-repository/customizing-dependency-updates.md
@@ -4,6 +4,8 @@ intro: 'You can customize how {% data variables.product.prodname_dependabot %} m
permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_dependabot %} for the repository.'
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md b/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md
index 77d1e3d332..1e5e81df5b 100644
--- a/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md
+++ b/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Use a *.gitattributes* file to mark files that match a given "pattern" with the specified attributes. A *.gitattributes* file uses the same rules for matching as _.gitignore_ files. For more information, see [PATTERN FORMAT](https://www.git-scm.com/docs/gitignore#_pattern_format) in the Git documentation.
diff --git a/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md
index 10a7cc5654..beb609f0db 100644
--- a/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md
+++ b/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Until you add an image, repository links expand to show basic information about the repository and the owner's avatar. Adding an image to your repository can help identify your project across various social platforms.
diff --git a/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md b/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md
index ddf52fc18c..584181f842 100644
--- a/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md
+++ b/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md
@@ -11,5 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/deleting-a-repository.md b/content/github/administering-a-repository/deleting-a-repository.md
index 87e00bcbfc..51abc910fb 100644
--- a/content/github/administering-a-repository/deleting-a-repository.md
+++ b/content/github/administering-a-repository/deleting-a-repository.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.organizations.owners-and-admins-can %} delete an organization repository. If **Allow members to delete or transfer repositories for this organization** has been disabled, only organization owners can delete organization repositories. {% data reusables.organizations.new-repo-permissions-more-info %}
diff --git a/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md
index 69b1689383..ea22b7c9f4 100644
--- a/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md
+++ b/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### Deleting a branch used for a pull request
diff --git a/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md
index 4027f7cfc1..d7afb49e30 100644
--- a/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md
+++ b/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md
index 4edba4dded..e665938671 100644
--- a/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md
+++ b/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/displaying-a-sponsor-button-in-your-repository
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
### About FUNDING files
diff --git a/content/github/administering-a-repository/enabling-and-disabling-version-updates.md b/content/github/administering-a-repository/enabling-and-disabling-version-updates.md
index 2b92ea8b18..e84fe4da5c 100644
--- a/content/github/administering-a-repository/enabling-and-disabling-version-updates.md
+++ b/content/github/administering-a-repository/enabling-and-disabling-version-updates.md
@@ -4,6 +4,8 @@ intro: 'You can configure your repository so that {% data variables.product.prod
permissions: 'People with write permissions to a repository can enable or disable {% data variables.product.prodname_dependabot_version_updates %} for the repository.'
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note-no-link %}
diff --git a/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md b/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md
index 9937e19241..0ec0ad3282 100644
--- a/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md
+++ b/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md
@@ -5,6 +5,8 @@ product: '{% data reusables.gated-features.discussions %}'
permissions: People with admin permissions to a repository can enable discussions for the repository.
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.discussions.beta %}
diff --git a/content/github/administering-a-repository/index.md b/content/github/administering-a-repository/index.md
index 1a2e46445c..6c1ae35807 100644
--- a/content/github/administering-a-repository/index.md
+++ b/content/github/administering-a-repository/index.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-dependabot.md b/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-dependabot.md
index 4e6c7b54b8..212bf528dd 100644
--- a/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-dependabot.md
+++ b/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-dependabot.md
@@ -5,6 +5,8 @@ redirect_from:
- /github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/keeping-your-dependencies-updated-automatically.md b/content/github/administering-a-repository/keeping-your-dependencies-updated-automatically.md
index 3c6c79af15..5b7076daa1 100644
--- a/content/github/administering-a-repository/keeping-your-dependencies-updated-automatically.md
+++ b/content/github/administering-a-repository/keeping-your-dependencies-updated-automatically.md
@@ -4,5 +4,7 @@ intro: '{% data variables.product.prodname_dependabot %} can maintain your repos
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/linking-to-releases.md b/content/github/administering-a-repository/linking-to-releases.md
index 8d87615b86..b6cb7bbcba 100644
--- a/content/github/administering-a-repository/linking-to-releases.md
+++ b/content/github/administering-a-repository/linking-to-releases.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/administering-a-repository/listing-dependencies-configured-for-version-updates.md b/content/github/administering-a-repository/listing-dependencies-configured-for-version-updates.md
index 19a0c93aee..5fb3ca1c67 100644
--- a/content/github/administering-a-repository/listing-dependencies-configured-for-version-updates.md
+++ b/content/github/administering-a-repository/listing-dependencies-configured-for-version-updates.md
@@ -3,6 +3,8 @@ title: Listing dependencies configured for version updates
intro: 'You can view the dependencies that {% data variables.product.prodname_dependabot %} monitors for updates.'
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/managing-a-branch-protection-rule.md b/content/github/administering-a-repository/managing-a-branch-protection-rule.md
index 06a6d484d7..38384638d7 100644
--- a/content/github/administering-a-repository/managing-a-branch-protection-rule.md
+++ b/content/github/administering-a-repository/managing-a-branch-protection-rule.md
@@ -21,6 +21,8 @@ versions:
enterprise-server: '*'
github-ae: '*'
permissions: People with admin permissions to a repository can manage branch protection rules.
+topics:
+ - repositories
---
### About branch protection rules
diff --git a/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md b/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md
index d6c7398e98..e4495dda34 100644
--- a/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md
+++ b/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.secret-scanning.beta %}
diff --git a/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md
index 8773a1704d..0e7cb11f0f 100644
--- a/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md
+++ b/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md
@@ -1,12 +1,14 @@
---
title: Managing auto-merge for pull requests in your repository
-intro: "You can allow or disallow auto-merge for pull requests in your repository."
+intro: You can allow or disallow auto-merge for pull requests in your repository.
product: '{% data reusables.gated-features.auto-merge %}'
versions:
free-pro-team: '*'
enterprise-server: '>=3.1'
github-ae: '*'
permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository.
+topics:
+ - repositories
---
If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)."
diff --git a/content/github/administering-a-repository/managing-branches-in-your-repository.md b/content/github/administering-a-repository/managing-branches-in-your-repository.md
index 2688f35f9e..c59c70f2b2 100644
--- a/content/github/administering-a-repository/managing-branches-in-your-repository.md
+++ b/content/github/administering-a-repository/managing-branches-in-your-repository.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md b/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md
index a4bb51ee20..f8f65c1c80 100644
--- a/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md
+++ b/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>3.0'
github-ae: '*'
+topics:
+ - repositories
---
### About {% data variables.large_files.product_name_short %} objects in archives
diff --git a/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md b/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md
index ebe089535a..ed3277df69 100644
--- a/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md
+++ b/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md
@@ -3,6 +3,8 @@ title: Managing pull requests for dependency updates
intro: 'You manage pull requests raised by {% data variables.product.prodname_dependabot %} in much the same way as other pull requests, but there are some extra options.'
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/administering-a-repository/managing-releases-in-a-repository.md b/content/github/administering-a-repository/managing-releases-in-a-repository.md
index fb779d9e7c..0998c7252e 100644
--- a/content/github/administering-a-repository/managing-releases-in-a-repository.md
+++ b/content/github/administering-a-repository/managing-releases-in-a-repository.md
@@ -13,6 +13,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" or currentVersion ver_gt "github-ae@latest" %}
diff --git a/content/github/administering-a-repository/managing-repository-settings.md b/content/github/administering-a-repository/managing-repository-settings.md
index fe7f46cdc3..d62b9d82b2 100644
--- a/content/github/administering-a-repository/managing-repository-settings.md
+++ b/content/github/administering-a-repository/managing-repository-settings.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md b/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md
index f652543a23..4eed68ffc8 100644
--- a/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md
+++ b/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" %}
@@ -27,7 +29,7 @@ You can manage a subset of security and analysis features for public repositorie
### Enabling or disabling security and analysis features{% if currentVersion == "free-pro-team@latest" %} for private repositories{% endif %}
-You can manage the security and analysis features for your {% if currentVersion == "free-pro-team@latest" %}private or internal {% endif %}repository.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} If your organization or enterprise has a license for {% data variables.product.prodname_GH_advanced_security %} then extra options are available. {% data reusables.advanced-security.more-info-ghas %}{% endif %}
+You can manage the security and analysis features for your {% if currentVersion == "free-pro-team@latest" %}private or internal {% endif %}repository.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} If your organization belongs to an enterprise with a license for {% data variables.product.prodname_GH_advanced_security %} then extra options are available. {% data reusables.advanced-security.more-info-ghas %}{% endif %}
{% data reusables.security.security-and-analysis-features-enable-read-only %}
diff --git a/content/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository.md b/content/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository.md
index 9e38d3ccec..fc4dac0766 100644
--- a/content/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository.md
+++ b/content/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/administering-a-repository/managing-people-and-teams-with-access-to-your-repository
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
### About managing access to your repository
diff --git a/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md
index f165dc4986..ffa5b30e4a 100644
--- a/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md
+++ b/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Anyone with admin permissions to a repository can enable or disable the automatic deletion of branches.
diff --git a/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md b/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md
index 94e4afbdf9..6d6be04cd2 100644
--- a/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md
+++ b/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
An organization owner must allow forks of private{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories on the organization level before you can allow or disallow forks for a specific repository. For more information, see "[Managing the forking policy for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)."
diff --git a/content/github/administering-a-repository/releasing-projects-on-github.md b/content/github/administering-a-repository/releasing-projects-on-github.md
index 372ed4cafc..0ee087417a 100644
--- a/content/github/administering-a-repository/releasing-projects-on-github.md
+++ b/content/github/administering-a-repository/releasing-projects-on-github.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/renaming-a-branch.md b/content/github/administering-a-repository/renaming-a-branch.md
index 7b23d9d5d5..2386a11954 100644
--- a/content/github/administering-a-repository/renaming-a-branch.md
+++ b/content/github/administering-a-repository/renaming-a-branch.md
@@ -5,6 +5,8 @@ permissions: People with write permissions to a repository can rename a branch i
versions:
free-pro-team: '*'
enterprise-server: '>=3.1'
+topics:
+ - repositories
---
### About renaming branches
diff --git a/content/github/administering-a-repository/renaming-a-repository.md b/content/github/administering-a-repository/renaming-a-repository.md
index 49b2a1bb30..57638a77a7 100644
--- a/content/github/administering-a-repository/renaming-a-repository.md
+++ b/content/github/administering-a-repository/renaming-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
When you rename a repository, all existing information, with the exception of project site URLs, is automatically redirected to the new name, including:
diff --git a/content/github/administering-a-repository/restoring-a-deleted-repository.md b/content/github/administering-a-repository/restoring-a-deleted-repository.md
index 7f8ac645e7..52e4b9e21e 100644
--- a/content/github/administering-a-repository/restoring-a-deleted-repository.md
+++ b/content/github/administering-a-repository/restoring-a-deleted-repository.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/restoring-a-deleted-repository
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
Anyone can restore deleted repositories that were owned by their own user account. Organization owners can restore deleted repositories that were owned by the organization.
diff --git a/content/github/administering-a-repository/securing-your-repository.md b/content/github/administering-a-repository/securing-your-repository.md
index 73f4af51ea..357d9148e6 100644
--- a/content/github/administering-a-repository/securing-your-repository.md
+++ b/content/github/administering-a-repository/securing-your-repository.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/administering-a-repository/setting-repository-visibility.md b/content/github/administering-a-repository/setting-repository-visibility.md
index aacaffa8b6..587bf86a29 100644
--- a/content/github/administering-a-repository/setting-repository-visibility.md
+++ b/content/github/administering-a-repository/setting-repository-visibility.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About repository visibility changes
@@ -25,7 +27,7 @@ We recommend reviewing the following caveats before you change the visibility of
* If you're using {% data variables.product.prodname_free_user %} for user accounts or organizations, some features won't be available in the repository after you change the visibility to private. {% data reusables.gated-features.more-info %}{% endif %}
* Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %}
* {% data variables.product.prodname_dotcom %} will no longer include the repository in the {% data variables.product.prodname_archive %}. For more information, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)."{% endif %}{% if currentVersion == "free-pro-team@latest" %}
-* {% data variables.product.prodname_GH_advanced_security %} features, such as {% data variables.product.prodname_code_scanning %}, will stop working unless the repository is owned by an organization that has a license for {% data variables.product.prodname_advanced_security %} with sufficient spare seats. {% data reusables.advanced-security.more-info-ghas %}{% endif %}{% if enterpriseServerVersions contains currentVersion %}
+* {% data variables.product.prodname_GH_advanced_security %} features, such as {% data variables.product.prodname_code_scanning %}, will stop working unless the repository is owned by an organization that is part of an enterprise with a license for {% data variables.product.prodname_advanced_security %} and sufficient spare seats. {% data reusables.advanced-security.more-info-ghas %}{% endif %}{% if enterpriseServerVersions contains currentVersion %}
* Anonymous Git read access is no longer available. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)."{% endif %}
{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
diff --git a/content/github/administering-a-repository/transferring-a-repository.md b/content/github/administering-a-repository/transferring-a-repository.md
index 95343d8a7a..94388ad8a4 100644
--- a/content/github/administering-a-repository/transferring-a-repository.md
+++ b/content/github/administering-a-repository/transferring-a-repository.md
@@ -16,6 +16,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About repository transfers
diff --git a/content/github/administering-a-repository/troubleshooting-required-status-checks.md b/content/github/administering-a-repository/troubleshooting-required-status-checks.md
index d07532b5f4..3424fb27b7 100644
--- a/content/github/administering-a-repository/troubleshooting-required-status-checks.md
+++ b/content/github/administering-a-repository/troubleshooting-required-status-checks.md
@@ -1,11 +1,13 @@
---
title: Troubleshooting required status checks
-intro: 'You can check for common errors and resolve issues with required status checks.'
+intro: You can check for common errors and resolve issues with required status checks.
product: '{% data reusables.gated-features.protected-branches %}'
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
If you have a check and a status with the same name, and you select that name as a required status check, both the check and the status are required. For more information, see "[Checks](/rest/reference/checks)."
diff --git a/content/github/administering-a-repository/viewing-branches-in-your-repository.md b/content/github/administering-a-repository/viewing-branches-in-your-repository.md
index ce60dccc84..f2c4839806 100644
--- a/content/github/administering-a-repository/viewing-branches-in-your-repository.md
+++ b/content/github/administering-a-repository/viewing-branches-in-your-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.navigate-to-branches %}
diff --git a/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md b/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md
index 9c6758f8c1..d551f5f755 100644
--- a/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md
+++ b/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% note %}
diff --git a/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md b/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md
index e11d111666..bc64774ab1 100644
--- a/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md
+++ b/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
diff --git a/content/github/authenticating-to-github/about-anonymized-image-urls.md b/content/github/authenticating-to-github/about-anonymized-image-urls.md
index d36acb1003..f1f469fcb0 100644
--- a/content/github/authenticating-to-github/about-anonymized-image-urls.md
+++ b/content/github/authenticating-to-github/about-anonymized-image-urls.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/about-anonymized-image-urls
versions:
free-pro-team: '*'
+topics:
+ - identity
+ - access management
---
To host your images, {% data variables.product.product_name %} uses the [open-source project Camo](https://github.com/atmos/camo). Camo generates an anonymous URL proxy for each image which hides your browser details and related information from other users. The URL starts `https://.githubusercontent.com/`, with different subdomains depending on how you uploaded the image.
diff --git a/content/github/authenticating-to-github/about-authentication-to-github.md b/content/github/authenticating-to-github/about-authentication-to-github.md
index c7d1f21a1a..1f3dad6026 100644
--- a/content/github/authenticating-to-github/about-authentication-to-github.md
+++ b/content/github/authenticating-to-github/about-authentication-to-github.md
@@ -5,6 +5,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
### About authentication to {% data variables.product.prodname_dotcom %}
diff --git a/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md b/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md
index bb6b3e7304..c7f6ff6491 100644
--- a/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md
+++ b/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
github-ae: '*'
+topics:
+ - sso
---
### About authentication with SAML SSO
diff --git a/content/github/authenticating-to-github/about-commit-signature-verification.md b/content/github/authenticating-to-github/about-commit-signature-verification.md
index 4c51889491..77a2b528ca 100644
--- a/content/github/authenticating-to-github/about-commit-signature-verification.md
+++ b/content/github/authenticating-to-github/about-commit-signature-verification.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
### About commit signature verification
diff --git a/content/github/authenticating-to-github/about-githubs-ip-addresses.md b/content/github/authenticating-to-github/about-githubs-ip-addresses.md
index 0ffa4bb10a..1718f9d21c 100644
--- a/content/github/authenticating-to-github/about-githubs-ip-addresses.md
+++ b/content/github/authenticating-to-github/about-githubs-ip-addresses.md
@@ -10,6 +10,9 @@ redirect_from:
- /articles/about-githubs-ip-addresses
versions:
free-pro-team: '*'
+topics:
+ - identity
+ - access management
---
You can retrieve a list of {% data variables.product.prodname_dotcom %}'s IP addresses from the [meta](https://api.github.com/meta) API endpoint. For more information, see "[Meta](/rest/reference/meta)."
diff --git a/content/github/authenticating-to-github/about-ssh.md b/content/github/authenticating-to-github/about-ssh.md
index e6d03cbea3..2eaef9677c 100644
--- a/content/github/authenticating-to-github/about-ssh.md
+++ b/content/github/authenticating-to-github/about-ssh.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
When you set up SSH, you'll [generate an SSH key and add it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and then [add the key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). Adding the SSH key to the ssh-agent ensures that your SSH key has an extra layer of security through the use of a passphrase. For more information, see "[Working with SSH key passphrases](/articles/working-with-ssh-key-passphrases)."
diff --git a/content/github/authenticating-to-github/about-two-factor-authentication.md b/content/github/authenticating-to-github/about-two-factor-authentication.md
index 478630fc95..fec3b375c2 100644
--- a/content/github/authenticating-to-github/about-two-factor-authentication.md
+++ b/content/github/authenticating-to-github/about-two-factor-authentication.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
For {% data variables.product.product_name %}, the second form of authentication is a code that's generated by an application on your mobile device{% if currentVersion == "free-pro-team@latest" %} or sent as a text message (SMS){% endif %}. After you enable 2FA, {% data variables.product.product_name %} generates an authentication code any time someone attempts to sign into your {% data variables.product.product_name %} account. The only way someone can sign into your account is if they know both your password and have access to the authentication code on your phone.
diff --git a/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md b/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md
index 4310af7d71..0b15769178 100644
--- a/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md
+++ b/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
With two-factor authentication enabled, you'll need to provide an authentication code when accessing {% data variables.product.product_name %} through your browser. If you access {% data variables.product.product_name %} using other methods, such as the API or the command line, you'll need to use an alternative form of authentication. For more information, see "[About authentication to {% data variables.product.prodname_dotcom %}](/github/authenticating-to-github/about-authentication-to-github)."
diff --git a/content/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account.md b/content/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account.md
index e8c4ba5e23..6df4b4b162 100644
--- a/content/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account.md
+++ b/content/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
Before adding a new GPG key to your {% data variables.product.product_name %} account, you should have:
diff --git a/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md
index 668b00c955..0638c2432f 100644
--- a/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md
+++ b/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
Before adding a new SSH key to your {% data variables.product.product_name %} account, you should have:
diff --git a/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md b/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md
index 79bf3d46bf..895402d671 100644
--- a/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md
+++ b/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% note %}
diff --git a/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md b/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md
index e1cc609301..bd089ba9e7 100644
--- a/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md
+++ b/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md
@@ -9,5 +9,7 @@ redirect_from:
versions:
free-pro-team: '*'
github-ae: '*'
+topics:
+ - sso
---
diff --git a/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md b/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md
index 6b52b66658..f7d73042d1 100644
--- a/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md
+++ b/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - sso
---
You can authorize an existing personal access token, or [create a new personal access token](/github/authenticating-to-github/creating-a-personal-access-token) and then authorize it.
diff --git a/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md b/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md
index ee2b69a4b7..dd401111ea 100644
--- a/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md
+++ b/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - sso
---
You can authorize an existing SSH key, or create a new SSH key and then authorize it. For more information about creating a new SSH key, see "[Generating a new SSH key and adding it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)."
diff --git a/content/github/authenticating-to-github/authorizing-oauth-apps.md b/content/github/authenticating-to-github/authorizing-oauth-apps.md
index dca4ac4c69..6c32b4a444 100644
--- a/content/github/authenticating-to-github/authorizing-oauth-apps.md
+++ b/content/github/authenticating-to-github/authorizing-oauth-apps.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
When an {% data variables.product.prodname_oauth_app %} wants to identify you by your {% data variables.product.product_name %} account, you'll see a page with the app's developer contact information and a list of the specific data that's being requested.
diff --git a/content/github/authenticating-to-github/changing-two-factor-authentication-delivery-methods-for-your-mobile-device.md b/content/github/authenticating-to-github/changing-two-factor-authentication-delivery-methods-for-your-mobile-device.md
index c2889d5547..b57c38d604 100644
--- a/content/github/authenticating-to-github/changing-two-factor-authentication-delivery-methods-for-your-mobile-device.md
+++ b/content/github/authenticating-to-github/changing-two-factor-authentication-delivery-methods-for-your-mobile-device.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/changing-two-factor-authentication-delivery-methods-for-your-mobile-device
versions:
free-pro-team: '*'
+topics:
+ - 2fa
---
{% note %}
diff --git a/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md b/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md
index 1ffc22df36..0abd12c197 100644
--- a/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md
+++ b/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.gpg.supported-gpg-key-algorithms %}
diff --git a/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md
index 9a95a12d6b..1131f1f04e 100644
--- a/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md
+++ b/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
{% data reusables.ssh.dsa-support %}
diff --git a/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md
index 2e7403a50f..36d736bca8 100644
--- a/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md
+++ b/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
### Checking your commit signature verification status
diff --git a/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md
index 937293a143..ac37753066 100644
--- a/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md
+++ b/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md
@@ -11,6 +11,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
In addition to securely storing your two-factor authentication recovery codes, we strongly recommend configuring one or more additional recovery methods.
diff --git a/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/content/github/authenticating-to-github/configuring-two-factor-authentication.md
index bc352f983e..3066f68814 100644
--- a/content/github/authenticating-to-github/configuring-two-factor-authentication.md
+++ b/content/github/authenticating-to-github/configuring-two-factor-authentication.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
You can configure two-factor authentication using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}. You can also add a security key.
diff --git a/content/github/authenticating-to-github/connecting-to-github-with-ssh.md b/content/github/authenticating-to-github/connecting-to-github-with-ssh.md
index 2f82f7db52..09ce32816e 100644
--- a/content/github/authenticating-to-github/connecting-to-github-with-ssh.md
+++ b/content/github/authenticating-to-github/connecting-to-github-with-ssh.md
@@ -15,5 +15,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
diff --git a/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/content/github/authenticating-to-github/connecting-with-third-party-applications.md
index a0e789b822..5ffb4b5bf2 100644
--- a/content/github/authenticating-to-github/connecting-with-third-party-applications.md
+++ b/content/github/authenticating-to-github/connecting-with-third-party-applications.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
When a third-party application wants to identify you by your {% data variables.product.product_name %} login, you'll see a page with the developer contact information and a list of the specific data that's being requested.
diff --git a/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md b/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md
index aa7dc1332f..95d39a899a 100644
--- a/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md
+++ b/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/countries-where-sms-authentication-is-supported
versions:
free-pro-team: '*'
+topics:
+ - 2fa
---
If we don't support two-factor authentication via text message for your country of residence, you can set up authentication via a TOTP mobile application. For more information, see "[Configuring two-factor authentication](/articles/configuring-two-factor-authentication)."
diff --git a/content/github/authenticating-to-github/creating-a-personal-access-token.md b/content/github/authenticating-to-github/creating-a-personal-access-token.md
index eb78e05486..2340dc5433 100644
--- a/content/github/authenticating-to-github/creating-a-personal-access-token.md
+++ b/content/github/authenticating-to-github/creating-a-personal-access-token.md
@@ -10,6 +10,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
Personal access tokens (PATs) are an alternative to using passwords for authentication to {% data variables.product.product_name %} when using the [GitHub API](/rest/overview/other-authentication-methods#via-oauth-and-personal-access-tokens) or the [command line](#using-a-token-on-the-command-line).
diff --git a/content/github/authenticating-to-github/creating-a-strong-password.md b/content/github/authenticating-to-github/creating-a-strong-password.md
index 754ca8c949..db2e968ad7 100644
--- a/content/github/authenticating-to-github/creating-a-strong-password.md
+++ b/content/github/authenticating-to-github/creating-a-strong-password.md
@@ -7,6 +7,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - identity
+ - access management
---
You must choose or generate a password for your {% data variables.product.product_name %} account that is at least:
diff --git a/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md b/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md
index a815793bf9..2d62415729 100644
--- a/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md
+++ b/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/deleted-or-missing-ssh-keys
versions:
free-pro-team: '*'
+topics:
+ - ssh
---
{% data variables.product.prodname_dotcom %} automatically deletes inactive SSH keys to help keep accounts safe, such as after someone leaves a job or loses a computer.
diff --git a/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md b/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md
index 6364fe6238..334725eabb 100644
--- a/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md
+++ b/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
We strongly recommend using two-factor authentication to secure your account. If you need to disable 2FA, we recommend re-enabling it as soon as possible.
diff --git a/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md b/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md
index ad63b888c3..0a0cf75aaf 100644
--- a/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md
+++ b/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
When trying to SSH into {% data variables.product.product_location %} on a Linux computer, you may see the following message in your terminal:
diff --git a/content/github/authenticating-to-github/error-bad-file-number.md b/content/github/authenticating-to-github/error-bad-file-number.md
index af70808b43..c652063f74 100644
--- a/content/github/authenticating-to-github/error-bad-file-number.md
+++ b/content/github/authenticating-to-github/error-bad-file-number.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
When running remote Git commands or SSH, your connection might time out:
diff --git a/content/github/authenticating-to-github/error-key-already-in-use.md b/content/github/authenticating-to-github/error-key-already-in-use.md
index 2e4c52a8bf..91003389a0 100644
--- a/content/github/authenticating-to-github/error-key-already-in-use.md
+++ b/content/github/authenticating-to-github/error-key-already-in-use.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
### Finding where the key has been used
diff --git a/content/github/authenticating-to-github/error-permission-denied-publickey.md b/content/github/authenticating-to-github/error-permission-denied-publickey.md
index 6057153d6b..6c57fec292 100644
--- a/content/github/authenticating-to-github/error-permission-denied-publickey.md
+++ b/content/github/authenticating-to-github/error-permission-denied-publickey.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
### Should the `sudo` command be used with Git?
diff --git a/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md b/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md
index f45e846a3e..51660edaec 100644
--- a/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md
+++ b/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
To fix this, the owner of the repository (`user`) needs to add your account (`other-user`) as a collaborator on the repository or to a team that has write access to the repository.
diff --git a/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md b/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md
index dda09ea92a..818e7dc717 100644
--- a/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md
+++ b/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
To fix this, remove the deploy key from the repository, and [add the key to your user account](/articles/adding-a-new-ssh-key-to-your-github-account) instead.
diff --git a/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md b/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md
index 3d9d3e3fad..9699bf3bc7 100644
--- a/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md
+++ b/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
The `-K` option is in Apple's standard version of `ssh-add`, which stores the passphrase in your keychain for you when you add an ssh key to the ssh-agent. If you have installed a different version of `ssh-add`, it may lack support for `-K`.
diff --git a/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md
index 1c844c3838..1d0e213750 100644
--- a/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md
+++ b/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok
versions:
free-pro-team: '*'
+topics:
+ - ssh
---
The error you receive may look like the following:
diff --git a/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md b/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md
index 3ca153f2df..fadb01e5fd 100644
--- a/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md
+++ b/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
When using an unverified key to perform Git operations, you will be prompted to perform an audit of your SSH keys.
diff --git a/content/github/authenticating-to-github/generating-a-new-gpg-key.md b/content/github/authenticating-to-github/generating-a-new-gpg-key.md
index b02d4f0cef..65069037b2 100644
--- a/content/github/authenticating-to-github/generating-a-new-gpg-key.md
+++ b/content/github/authenticating-to-github/generating-a-new-gpg-key.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.gpg.supported-gpg-key-algorithms %}
diff --git a/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md
index 020d609a12..93182ab506 100644
--- a/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md
+++ b/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
If you don't already have an SSH key, you must [generate a new SSH key](#generating-a-new-ssh-key). If you're unsure whether you already have an SSH key, check for [existing keys](/articles/checking-for-existing-ssh-keys).
diff --git a/content/github/authenticating-to-github/githubs-ssh-key-fingerprints.md b/content/github/authenticating-to-github/githubs-ssh-key-fingerprints.md
index 309b4e69c1..6b47b5874f 100644
--- a/content/github/authenticating-to-github/githubs-ssh-key-fingerprints.md
+++ b/content/github/authenticating-to-github/githubs-ssh-key-fingerprints.md
@@ -7,6 +7,9 @@ redirect_from:
- /articles/githubs-ssh-key-fingerprints
versions:
free-pro-team: '*'
+topics:
+ - identity
+ - access management
---
These are {% data variables.product.prodname_dotcom %}'s public key fingerprints:
diff --git a/content/github/authenticating-to-github/index.md b/content/github/authenticating-to-github/index.md
index 30e51c7087..d59e1b78c4 100644
--- a/content/github/authenticating-to-github/index.md
+++ b/content/github/authenticating-to-github/index.md
@@ -17,6 +17,12 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - 2fa
+ - identity
+ - access management
+ - usernames
+ - device verification
---
diff --git a/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md b/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md
index 183fecb7f3..f2cceaccef 100644
--- a/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md
+++ b/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md
@@ -8,5 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
diff --git a/content/github/authenticating-to-github/managing-commit-signature-verification.md b/content/github/authenticating-to-github/managing-commit-signature-verification.md
index da61d71196..1402793ca0 100644
--- a/content/github/authenticating-to-github/managing-commit-signature-verification.md
+++ b/content/github/authenticating-to-github/managing-commit-signature-verification.md
@@ -10,5 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
diff --git a/content/github/authenticating-to-github/preventing-unauthorized-access.md b/content/github/authenticating-to-github/preventing-unauthorized-access.md
index 79c9518fac..80cf7fc056 100644
--- a/content/github/authenticating-to-github/preventing-unauthorized-access.md
+++ b/content/github/authenticating-to-github/preventing-unauthorized-access.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - identity
+ - access management
---
{% data variables.product.product_name %} requires a password to perform sensitive actions, such as adding new SSH keys, authorizing applications, or modifying team members.
diff --git a/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md
index e3259b0eff..f6fad1ddb2 100644
--- a/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md
+++ b/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md b/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md
index fc251cc1e1..e5bc1c00c6 100644
--- a/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md
+++ b/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
{% mac %}
diff --git a/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md
index 55bd3a3601..95e6b04666 100644
--- a/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md
+++ b/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md
@@ -10,6 +10,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
The `git filter-branch` command and the BFG Repo-Cleaner rewrite your repository's history, which changes the SHAs for existing commits that you alter and any dependent commits. Changed commit SHAs may affect open pull requests in your repository. We recommend merging or closing all open pull requests before removing files from your repository.
diff --git a/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md b/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md
index ce1fd85a57..81cd79e7ff 100644
--- a/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md
+++ b/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.user_settings.access_settings %}
diff --git a/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md b/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md
index 6bbe5801e1..6423bac6f8 100644
--- a/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md
+++ b/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
### Reviewing your authorized {% data variables.product.prodname_oauth_app %}s
diff --git a/content/github/authenticating-to-github/reviewing-your-deploy-keys.md b/content/github/authenticating-to-github/reviewing-your-deploy-keys.md
index 85eba969b9..f6b160dfd0 100644
--- a/content/github/authenticating-to-github/reviewing-your-deploy-keys.md
+++ b/content/github/authenticating-to-github/reviewing-your-deploy-keys.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/authenticating-to-github/reviewing-your-security-log.md b/content/github/authenticating-to-github/reviewing-your-security-log.md
index 01aa0036e4..466c990e1c 100644
--- a/content/github/authenticating-to-github/reviewing-your-security-log.md
+++ b/content/github/authenticating-to-github/reviewing-your-security-log.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
### Accessing your security log
diff --git a/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
index ba3e70593d..2aec1117d3 100644
--- a/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
+++ b/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid.
diff --git a/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md b/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md
index 597dc2ed96..5dc2e4fc18 100644
--- a/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md
+++ b/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md
@@ -9,5 +9,7 @@ mapTopic: true
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - 2fa
---
diff --git a/content/github/authenticating-to-github/signing-commits.md b/content/github/authenticating-to-github/signing-commits.md
index fe4fefa5cb..247301e527 100644
--- a/content/github/authenticating-to-github/signing-commits.md
+++ b/content/github/authenticating-to-github/signing-commits.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.gpg.desktop-support-for-commit-signing %}
diff --git a/content/github/authenticating-to-github/signing-tags.md b/content/github/authenticating-to-github/signing-tags.md
index 7924021445..08026ad479 100644
--- a/content/github/authenticating-to-github/signing-tags.md
+++ b/content/github/authenticating-to-github/signing-tags.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% data reusables.gpg.desktop-support-for-commit-signing %}
diff --git a/content/github/authenticating-to-github/sudo-mode.md b/content/github/authenticating-to-github/sudo-mode.md
index 065f2c0582..a20303dd82 100644
--- a/content/github/authenticating-to-github/sudo-mode.md
+++ b/content/github/authenticating-to-github/sudo-mode.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - identity
+ - access management
---
After you've performed a sudo-protected action, you'll only be asked to re-authenticate again after a few hours of inactivity. Every sudo-protected action resets this timer.
diff --git a/content/github/authenticating-to-github/telling-git-about-your-signing-key.md b/content/github/authenticating-to-github/telling-git-about-your-signing-key.md
index 70780cac45..5fab6b7ab9 100644
--- a/content/github/authenticating-to-github/telling-git-about-your-signing-key.md
+++ b/content/github/authenticating-to-github/telling-git-about-your-signing-key.md
@@ -1,6 +1,6 @@
---
title: Telling Git about your signing key
-intro: "To sign commits locally, you need to inform Git that there's a GPG or X.509 key you'd like to use."
+intro: 'To sign commits locally, you need to inform Git that there''s a GPG or X.509 key you''d like to use.'
redirect_from:
- /articles/telling-git-about-your-gpg-key/
- /articles/telling-git-about-your-signing-key
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% mac %}
diff --git a/content/github/authenticating-to-github/testing-your-ssh-connection.md b/content/github/authenticating-to-github/testing-your-ssh-connection.md
index 1413718434..167a477bb5 100644
--- a/content/github/authenticating-to-github/testing-your-ssh-connection.md
+++ b/content/github/authenticating-to-github/testing-your-ssh-connection.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
Before testing your SSH connection, you should have:
diff --git a/content/github/authenticating-to-github/troubleshooting-commit-signature-verification.md b/content/github/authenticating-to-github/troubleshooting-commit-signature-verification.md
index eaf728188e..ae4ef0099e 100644
--- a/content/github/authenticating-to-github/troubleshooting-commit-signature-verification.md
+++ b/content/github/authenticating-to-github/troubleshooting-commit-signature-verification.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
diff --git a/content/github/authenticating-to-github/troubleshooting-ssh.md b/content/github/authenticating-to-github/troubleshooting-ssh.md
index 6e0edc6822..a7d35a006e 100644
--- a/content/github/authenticating-to-github/troubleshooting-ssh.md
+++ b/content/github/authenticating-to-github/troubleshooting-ssh.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
diff --git a/content/github/authenticating-to-github/updating-an-expired-gpg-key.md b/content/github/authenticating-to-github/updating-an-expired-gpg-key.md
index 15a8a860a3..0d76efd0fc 100644
--- a/content/github/authenticating-to-github/updating-an-expired-gpg-key.md
+++ b/content/github/authenticating-to-github/updating-an-expired-gpg-key.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
If your key is expired, you must [update the expiration](https://www.gnupg.org/gph/en/manual/c235.html#AEN328), export the new key, delete the expired key in your GitHub account, and [upload the new key to GitHub](/articles/adding-a-new-gpg-key-to-your-github-account/). Your previous commits and tags will show as verified, as long as the key meets all other verification requirements.
diff --git a/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/content/github/authenticating-to-github/updating-your-github-access-credentials.md
index 75214d3ae8..121deadaeb 100644
--- a/content/github/authenticating-to-github/updating-your-github-access-credentials.md
+++ b/content/github/authenticating-to-github/updating-your-github-access-credentials.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% if currentVersion != "github-ae@latest" %}
diff --git a/content/github/authenticating-to-github/using-a-verified-email-address-in-your-gpg-key.md b/content/github/authenticating-to-github/using-a-verified-email-address-in-your-gpg-key.md
index e215b0d4b5..f072a89dab 100644
--- a/content/github/authenticating-to-github/using-a-verified-email-address-in-your-gpg-key.md
+++ b/content/github/authenticating-to-github/using-a-verified-email-address-in-your-gpg-key.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - identity
+ - access management
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/authenticating-to-github/using-ssh-over-the-https-port.md b/content/github/authenticating-to-github/using-ssh-over-the-https-port.md
index ba712f9d73..05f7043e78 100644
--- a/content/github/authenticating-to-github/using-ssh-over-the-https-port.md
+++ b/content/github/authenticating-to-github/using-ssh-over-the-https-port.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/using-ssh-over-the-https-port
versions:
free-pro-team: '*'
+topics:
+ - ssh
---
{% tip %}
diff --git a/content/github/authenticating-to-github/viewing-and-managing-your-active-saml-sessions.md b/content/github/authenticating-to-github/viewing-and-managing-your-active-saml-sessions.md
index 4b3d9b9288..ce7b47ed3b 100644
--- a/content/github/authenticating-to-github/viewing-and-managing-your-active-saml-sessions.md
+++ b/content/github/authenticating-to-github/viewing-and-managing-your-active-saml-sessions.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/viewing-and-managing-your-active-saml-sessions
versions:
free-pro-team: '*'
+topics:
+ - sso
---
{% data reusables.user_settings.access_settings %}
@@ -24,4 +26,4 @@ versions:
### Further reading
-- "[About authentication with SAML SSO](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)"
\ No newline at end of file
+- "[About authentication with SAML SSO](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)"
diff --git a/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md
index 81917a1cc1..859778b9eb 100644
--- a/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md
+++ b/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - ssh
---
With SSH keys, if someone gains access to your computer, they also gain access to every system that uses that key. To add an extra layer of security, you can add a passphrase to your SSH key. You can use `ssh-agent` to securely save your passphrase so you don't have to reenter it.
diff --git a/content/github/building-a-strong-community/about-community-management-and-moderation.md b/content/github/building-a-strong-community/about-community-management-and-moderation.md
index 1e693282d9..f4a26afaa9 100644
--- a/content/github/building-a-strong-community/about-community-management-and-moderation.md
+++ b/content/github/building-a-strong-community/about-community-management-and-moderation.md
@@ -3,6 +3,8 @@ title: About community management and moderation
intro: '{% data variables.product.prodname_dotcom %} offers tools that help repository maintainers establish and enforce standards of behavior in their communities on {% data variables.product.prodname_dotcom_the_website %}.'
versions:
free-pro-team: '*'
+topics:
+ - community
---
### About community management and moderation
diff --git a/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md b/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md
index 5e1f3a28ef..5876ae99d6 100644
--- a/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md
+++ b/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/about-community-profiles-for-public-repositories
versions:
free-pro-team: '*'
+topics:
+ - community
---
The community profile checklist checks to see if a project includes recommended community health files, such as README, CODE_OF_CONDUCT, LICENSE, or CONTRIBUTING, in a supported location. For more information, see "[Accessing a project's community profile](/articles/accessing-a-project-s-community-profile)."
diff --git a/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md b/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md
index 8d8c0a7b0e..7f3ecabf3e 100644
--- a/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md
+++ b/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
After you create issue and pull request templates in your repository, contributors can use the templates to open issues or describe the proposed changes in their pull requests according to the repository's contributing guidelines. For more information about adding contributing guidelines to a repository, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors)."
diff --git a/content/github/building-a-strong-community/about-wikis.md b/content/github/building-a-strong-community/about-wikis.md
index 6e0beec462..39ebce9237 100644
--- a/content/github/building-a-strong-community/about-wikis.md
+++ b/content/github/building-a-strong-community/about-wikis.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
Every {% data variables.product.product_name %} repository comes equipped with a section for hosting documentation, called a wiki. You can use your repository's wiki to share long-form content about your project, such as how to use it, how you designed it, or its core principles. A README file quickly tells what your project can do, while you can use a wiki to provide additional documentation. For more information, see "[About READMEs](/articles/about-readmes)."
diff --git a/content/github/building-a-strong-community/accessing-a-projects-community-profile.md b/content/github/building-a-strong-community/accessing-a-projects-community-profile.md
index d145d7dd83..2b20b15381 100644
--- a/content/github/building-a-strong-community/accessing-a-projects-community-profile.md
+++ b/content/github/building-a-strong-community/accessing-a-projects-community-profile.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/accessing-a-projects-community-profile
versions:
free-pro-team: '*'
+topics:
+ - community
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md b/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md
index aa7d99e071..c83fcd6804 100644
--- a/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md
+++ b/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/adding-a-code-of-conduct-to-your-project
versions:
free-pro-team: '*'
+topics:
+ - community
---
A *code of conduct* defines standards for how to engage in a community. It signals an inclusive environment that respects all contributions. It also outlines procedures for addressing problems between members of your project's community. For more information on why a code of conduct defines standards and expectations for how to engage in a community, see the [Open Source Guide](https://opensource.guide/code-of-conduct/).
diff --git a/content/github/building-a-strong-community/adding-a-license-to-a-repository.md b/content/github/building-a-strong-community/adding-a-license-to-a-repository.md
index 05d1c89413..b69cd607cd 100644
--- a/content/github/building-a-strong-community/adding-a-license-to-a-repository.md
+++ b/content/github/building-a-strong-community/adding-a-license-to-a-repository.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - community
---
If you include a detectable license in your repository, people who visit your repository will see it at the top of the repository page. To read the entire license file, click the license name.
diff --git a/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md b/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md
index 62ae605146..738e36f1ac 100644
--- a/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md
+++ b/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Adding wiki pages
diff --git a/content/github/building-a-strong-community/adding-support-resources-to-your-project.md b/content/github/building-a-strong-community/adding-support-resources-to-your-project.md
index 7fb6d57013..c16e886001 100644
--- a/content/github/building-a-strong-community/adding-support-resources-to-your-project.md
+++ b/content/github/building-a-strong-community/adding-support-resources-to-your-project.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
To direct people to specific support resources, you can add a SUPPORT file to your repository's root, `docs`, or `.github` folder. When someone creates an issue in your repository, they will see a link to your project's SUPPORT file.
diff --git a/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md b/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md
index 855f81f777..7a4a51f999 100644
--- a/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md
+++ b/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/blocking-a-user-from-your-organization
versions:
free-pro-team: '*'
+topics:
+ - community
---
You can block a user from within your organization's settings or from a specific comment made by the user. When you block a user in a comment, you can choose to send the user a notification explaining that they were blocked and why. Otherwise, the user is not directly notified that you've blocked them. Blocked users can still delete their existing content.
diff --git a/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md b/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md
index 77ef77338a..c2dc55ccef 100644
--- a/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md
+++ b/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/blocking-a-user-from-your-personal-account
versions:
free-pro-team: '*'
+topics:
+ - community
---
### About blocking users
diff --git a/content/github/building-a-strong-community/changing-access-permissions-for-wikis.md b/content/github/building-a-strong-community/changing-access-permissions-for-wikis.md
index 3cd1846dba..f8cc461171 100644
--- a/content/github/building-a-strong-community/changing-access-permissions-for-wikis.md
+++ b/content/github/building-a-strong-community/changing-access-permissions-for-wikis.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md
index 13df72ab27..d8686332e6 100644
--- a/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md
+++ b/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}
diff --git a/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/content/github/building-a-strong-community/creating-a-default-community-health-file.md
index c4157ac34c..373b288d0e 100644
--- a/content/github/building-a-strong-community/creating-a-default-community-health-file.md
+++ b/content/github/building-a-strong-community/creating-a-default-community-health-file.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - community
---
### About default community health files
diff --git a/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md b/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md
index 5e725a84aa..81a9895472 100644
--- a/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md
+++ b/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Creating a footer
diff --git a/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md b/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md
index 29ff888262..a0098f3058 100644
--- a/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md
+++ b/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)."
diff --git a/content/github/building-a-strong-community/disabling-wikis.md b/content/github/building-a-strong-community/disabling-wikis.md
index 1dc9587157..400b502f0e 100644
--- a/content/github/building-a-strong-community/disabling-wikis.md
+++ b/content/github/building-a-strong-community/disabling-wikis.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
When you turn off a wiki, the content is hidden, but not erased. If you choose to re-enable wikis later, your previous pages will be restored.
diff --git a/content/github/building-a-strong-community/documenting-your-project-with-wikis.md b/content/github/building-a-strong-community/documenting-your-project-with-wikis.md
index db5793db24..b653151038 100644
--- a/content/github/building-a-strong-community/documenting-your-project-with-wikis.md
+++ b/content/github/building-a-strong-community/documenting-your-project-with-wikis.md
@@ -11,5 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
diff --git a/content/github/building-a-strong-community/editing-wiki-content.md b/content/github/building-a-strong-community/editing-wiki-content.md
index d592597dd6..57e1e83f5e 100644
--- a/content/github/building-a-strong-community/editing-wiki-content.md
+++ b/content/github/building-a-strong-community/editing-wiki-content.md
@@ -15,6 +15,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Adding links
diff --git a/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md b/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md
index 95c92f2ede..54e3f5c09a 100644
--- a/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md
+++ b/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/helping-new-contributors-find-your-project-with-labels
versions:
free-pro-team: '*'
+topics:
+ - community
---
You can apply the `good first issue` label to issues in your public repository so that people can find them when searching by labels. For more information about searching by labels, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests/#search-by-label)."
diff --git a/content/github/building-a-strong-community/index.md b/content/github/building-a-strong-community/index.md
index 70d3a13506..96db2f1924 100644
--- a/content/github/building-a-strong-community/index.md
+++ b/content/github/building-a-strong-community/index.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
@@ -52,8 +54,3 @@ versions:
{% link_in_list /viewing-a-wikis-history-of-changes %}
{% link_in_list /changing-access-permissions-for-wikis %}
{% link_in_list /disabling-wikis %}
-{% topic_link_in_list /collaborating-with-your-team %}
- {% link_in_list /about-team-discussions %}
- {% link_in_list /creating-a-team-discussion %}
- {% link_in_list /editing-or-deleting-a-team-discussion %}
- {% link_in_list /pinning-a-team-discussion %}
diff --git a/content/github/building-a-strong-community/limiting-interactions-for-your-user-account.md b/content/github/building-a-strong-community/limiting-interactions-for-your-user-account.md
index 6c01ed2e08..b04377b01c 100644
--- a/content/github/building-a-strong-community/limiting-interactions-for-your-user-account.md
+++ b/content/github/building-a-strong-community/limiting-interactions-for-your-user-account.md
@@ -1,9 +1,11 @@
---
title: Limiting interactions for your user account
-intro: 'You can temporarily enforce a period of limited activity for certain users in all public repositories owned by your user account.'
+intro: You can temporarily enforce a period of limited activity for certain users in all public repositories owned by your user account.
versions:
free-pro-team: '*'
permissions: Anyone can limit interactions for their own user account.
+topics:
+ - community
---
### About temporary interaction limits
@@ -24,4 +26,4 @@ You can also block users. For more information, see "[Blocking a user from your
1. In your user settings sidebar, under "Moderation settings", click **Interaction limits**.
{% data reusables.community.set-interaction-limit %}
- 
\ No newline at end of file
+ 
diff --git a/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md b/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md
index 8c96c26302..d43d4be730 100644
--- a/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md
+++ b/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md
@@ -1,12 +1,14 @@
---
title: Limiting interactions in your organization
-intro: 'You can temporarily enforce a period of limited activity for certain users in all public repositories owned by your organization.'
+intro: You can temporarily enforce a period of limited activity for certain users in all public repositories owned by your organization.
redirect_from:
- /github/setting-up-and-managing-organizations-and-teams/limiting-interactions-in-your-organization
- /articles/limiting-interactions-in-your-organization
versions:
free-pro-team: '*'
permissions: Organization owners can limit interactions in an organization.
+topics:
+ - community
---
### About temporary interaction limits
diff --git a/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md b/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md
index da85594b43..3b7219a4c1 100644
--- a/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md
+++ b/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md
@@ -1,12 +1,14 @@
---
title: Limiting interactions in your repository
-intro: 'You can temporarily enforce a period of limited activity for certain users on a public repository.'
+intro: You can temporarily enforce a period of limited activity for certain users on a public repository.
redirect_from:
- /articles/limiting-interactions-with-your-repository/
- /articles/limiting-interactions-in-your-repository
versions:
free-pro-team: '*'
permissions: People with admin permissions to a repository can temporarily limit interactions in that repository.
+topics:
+ - community
---
### About temporary interaction limits
diff --git a/content/github/building-a-strong-community/locking-conversations.md b/content/github/building-a-strong-community/locking-conversations.md
index 7f384471b5..2035ce49d2 100644
--- a/content/github/building-a-strong-community/locking-conversations.md
+++ b/content/github/building-a-strong-community/locking-conversations.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible.
diff --git a/content/github/building-a-strong-community/maintaining-your-safety-on-github.md b/content/github/building-a-strong-community/maintaining-your-safety-on-github.md
index 5ace725492..72e9dbb00a 100644
--- a/content/github/building-a-strong-community/maintaining-your-safety-on-github.md
+++ b/content/github/building-a-strong-community/maintaining-your-safety-on-github.md
@@ -9,5 +9,7 @@ redirect_from:
- /articles/encouraging-positive-contributions-to-your-project
versions:
free-pro-team: '*'
+topics:
+ - community
---
diff --git a/content/github/building-a-strong-community/managing-disruptive-comments.md b/content/github/building-a-strong-community/managing-disruptive-comments.md
index 16acb1360c..9b41dd1009 100644
--- a/content/github/building-a-strong-community/managing-disruptive-comments.md
+++ b/content/github/building-a-strong-community/managing-disruptive-comments.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Hiding a comment
diff --git a/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md b/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md
index de50df47da..2bbba1c9fe 100644
--- a/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md
+++ b/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md
@@ -3,6 +3,8 @@ title: Managing how contributors report abuse in your organization's repository
intro: You can allow contributors to report disruptive behavior directly to repository maintainers.
versions:
free-pro-team: '*'
+topics:
+ - community
---
Anyone with admin permissions to a repository can manage how contributors report abuse in the repository.
diff --git a/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md b/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md
index 4dc4216243..790af089e2 100644
--- a/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md
+++ b/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md
@@ -3,6 +3,8 @@ title: Managing reported content in your organization's repository
intro: 'After a contributor reports disruptive content in a repository, repository maintainers can view and manage the report.'
versions:
free-pro-team: '*'
+topics:
+ - community
---
Anyone with admin permissions to a repository can view and manage reported content for the repository.
diff --git a/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md b/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md
index 8cb5adf5ce..3a22ec0bd1 100644
--- a/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md
+++ b/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% data reusables.repositories.legacy-issue-template-tip %}
diff --git a/content/github/building-a-strong-community/moderating-comments-and-conversations.md b/content/github/building-a-strong-community/moderating-comments-and-conversations.md
index 6b02dc83f3..68955777c3 100644
--- a/content/github/building-a-strong-community/moderating-comments-and-conversations.md
+++ b/content/github/building-a-strong-community/moderating-comments-and-conversations.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
diff --git a/content/github/building-a-strong-community/reporting-abuse-or-spam.md b/content/github/building-a-strong-community/reporting-abuse-or-spam.md
index e33cd7be4c..5570339879 100644
--- a/content/github/building-a-strong-community/reporting-abuse-or-spam.md
+++ b/content/github/building-a-strong-community/reporting-abuse-or-spam.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/reporting-abuse-or-spam
versions:
free-pro-team: '*'
+topics:
+ - community
---
Owners, collaborators, prior contributors, and people with write access can report issues, pull requests, and comments on issues, pull requests, and commits. Anyone can report apps in {% data variables.product.prodname_marketplace %}.
diff --git a/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md b/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md
index aca5e9c2ff..c529f52f84 100644
--- a/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md
+++ b/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
To help your project contributors do good work, you can add a file with contribution guidelines to your project repository's root, `docs`, or `.github` folder. When someone opens a pull request or creates an issue, they will see a link to that file.
diff --git a/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md b/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md
index 4779c2e8c9..bab3c8d57f 100644
--- a/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md
+++ b/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
diff --git a/content/github/building-a-strong-community/tracking-changes-in-a-comment.md b/content/github/building-a-strong-community/tracking-changes-in-a-comment.md
index 0af05d4355..9ddaa0094d 100644
--- a/content/github/building-a-strong-community/tracking-changes-in-a-comment.md
+++ b/content/github/building-a-strong-community/tracking-changes-in-a-comment.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Viewing a comment's edit history details
diff --git a/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md b/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md
index 616b702424..f0b25a83de 100644
--- a/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md
+++ b/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/unblocking-a-user-from-your-organization
versions:
free-pro-team: '*'
+topics:
+ - community
---
After unblocking a user from your organization, they'll be able to contribute to your organization's repositories.
diff --git a/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md b/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md
index f62dd1c2ac..49e3481749 100644
--- a/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md
+++ b/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/unblocking-a-user-from-your-personal-account
versions:
free-pro-team: '*'
+topics:
+ - community
---
When you unblock a user, they'll be able to invite you to be a collaborator to their repositories. If they [@mention you](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) anywhere on GitHub, you'll receive notifications.
diff --git a/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md b/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md
index 3435c8fa32..65848c631a 100644
--- a/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md
+++ b/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md
@@ -10,5 +10,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
diff --git a/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md b/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md
index caaad4013d..8af76dfd85 100644
--- a/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md
+++ b/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
### Viewing wiki history
diff --git a/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md b/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md
index 047ea789cc..27efafed8f 100644
--- a/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md
+++ b/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/viewing-users-who-are-blocked-from-your-organization
versions:
free-pro-team: '*'
+topics:
+ - community
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md b/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md
index 0f3bae172f..a5866bc295 100644
--- a/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md
+++ b/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/viewing-users-youve-blocked-from-your-personal-account
versions:
free-pro-team: '*'
+topics:
+ - community
---
{% data reusables.user_settings.access_settings %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/content/github/collaborating-with-issues-and-pull-requests/about-branches.md
index 14595a111a..016cc6cc7a 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-branches.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-branches.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md b/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md
index 7325304482..f9cec4d87c 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
There are two main types of development models with which you'd use pull requests. In the *fork and pull model*, anyone can fork an existing repository and push changes to their personal fork. You do not need permission to the source repository to push to a user-owned fork. The changes can be pulled into the source repository by the project maintainer. When you open a pull request proposing changes from your user-owned fork to a branch in the source (upstream) repository, you can allow anyone with push access to the upstream repository to make changes to your pull request. This model is popular with open source projects as it reduces the amount of friction for new contributors and allows people to work independently without upfront coordination.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md
index 7e07ded2be..10c3ea7475 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% note %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md b/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md
index 8e21b6d214..c88963f9b0 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### Discussions on {% data variables.product.product_name %}
@@ -16,7 +18,7 @@ You can create and participate in issues, pull requests, and team discussions, d
Issues are useful for discussing specific details of a project such as bug reports and planned improvements. For more information, see "[About issues](/articles/about-issues)." Pull requests allow you to comment directly on proposed changes. For more information, see "[About pull requests](/articles/about-pull-requests)" and "[Commenting on a pull request](/articles/commenting-on-a-pull-request)."
-{% data reusables.organizations.team-discussions-purpose %} For more information, see "[About team discussions](/articles/about-team-discussions)."
+{% data reusables.organizations.team-discussions-purpose %} For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
### Reacting to ideas in comments
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/content/github/collaborating-with-issues-and-pull-requests/about-forks.md
index c7acbb201e..a98a7988d3 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-forks.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-forks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Forking a repository is similar to copying a repository, with two major differences:
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md b/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md
index 8e10ed8b96..620828529a 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Git can often resolve differences between branches and merge them automatically. Usually, the changes are on different lines, or even in different files, which makes the merge simple for computers to understand. However, sometimes there are competing changes that Git can't resolve without your help. Often, merge conflicts happen when people make different changes to the same line of the same file, or when one person edits a file and another person deletes the same file.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md b/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md
index 140097bc99..7c0a215180 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.pull_requests.default_merge_option %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md b/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md
index cd9d144824..93a6a0374d 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About pull request reviews
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md b/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md
index ffba2f58cf..e157d032a5 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About pull requests
diff --git a/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md
index 4723d04971..cf4fb304a9 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Status checks are based on external processes, such as continuous integration builds, which run for each push you make to a repository. You can see the *pending*, *passing*, or *failing* state of status checks next to individual commits in your pull request.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md b/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md
index 496b92edd0..bc9829b98f 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md b/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md
index e84de9cf65..45d42c07a0 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Only pull request authors can give upstream repository maintainers, or those with push access to the upstream repository, permission to make commits to their pull request's compare branch in a user-owned fork. To learn more about upstream repositories, see "[About forks](/articles/about-forks)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md b/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md
index a6854818c4..04caa5fe36 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
For more information about required reviews, see "[About protected branches](/github/administering-a-repository/about-protected-branches#require-pull-request-reviews-before-merging)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md
index 3cfba31247..12d2eb2b92 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md
@@ -1,11 +1,13 @@
---
title: Automatically merging a pull request
-intro: 'You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.'
+intro: You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.
product: '{% data reusables.gated-features.auto-merge %}'
versions:
free-pro-team: '*'
enterprise-server: '>=3.1'
github-ae: '*'
+topics:
+ - pull requests
---
### About auto-merge
diff --git a/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md
index 2e5cf86f52..dc5773a4dd 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% warning %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md
index c8c46903c4..5684ef55c0 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### Marking a pull request as ready for review
diff --git a/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md b/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md
index 4ed1a97a60..edb7dbdb90 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% note %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request.md
index a6acb76c97..cfb5b3c972 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% tip %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
index e185d0a0cf..1d4bdbd223 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md
index 2f109a79d6..d40da420da 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About pull request comments
diff --git a/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md
index 0f38fb1a00..fe0ffb4d7a 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can only make commits on pull request branches that:
diff --git a/content/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork.md b/content/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork.md
index 357da89aed..8808971cdc 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.command_line.open_the_multi_os_terminal %}
2. List the current configured remote repository for your fork.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md
index 0aebcf7f57..a6de47b348 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can also give the upstream repository's maintainers permission to push commits to a user-owned fork. If your pull request compares your topic branch with a branch in the upstream repository as the base branch, then your topic branch is also called the compare branch of the pull request. For more information about pull request branches, including examples, see "[Creating a pull request](/articles/creating-a-pull-request/#changing-the-branch-range-and-destination-repository)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md
index 501339a84f..15326fe298 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Anyone with read permissions to a repository can create a pull request, but you must have write permissions to create a branch. If you want to create a new branch for your pull request and don't have write permissions to the repository, you can fork the repository first. For more information, see "[Creating a pull request from a fork](/articles/creating-a-pull-request-from-a-fork)" and "[About forks](/articles/about-forks)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md
index 4f0c487c12..c7618f3507 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### Creating a branch
diff --git a/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md
index 0f52e396f7..9a7a0aacc5 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.pull_requests.dismiss_review %}
@@ -26,4 +28,4 @@ This changes the status of the review to a review comment. When you dismiss a re
- "[About pull request reviews](/articles/about-pull-request-reviews)"
- "[Reviewing proposed changes in a pull request](/articles/reviewing-proposed-changes-in-a-pull-request)"
-- "[About protected branches](/github/administering-a-repository/about-protected-branches#require-pull-request-reviews-before-merging)"
\ No newline at end of file
+- "[About protected branches](/github/administering-a-repository/about-protected-branches#require-pull-request-reviews-before-merging)"
diff --git a/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md
index 8abfc72cb1..0f50ae18a7 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md
index 5b1ea925dc..4fe786ab06 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Anyone with read access to a repository can see a summary list of the functions and methods changes in certain files of a pull request.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/github-flow.md b/content/github/collaborating-with-issues-and-pull-requests/github-flow.md
index b94297ab44..9aceb77d6c 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/github-flow.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/github-flow.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### Following the GitHub flow
diff --git a/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md
index 0caba244c6..d6d564c409 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md
index 68bcb96e4a..b8db6db125 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### Applying suggested changes
diff --git a/content/github/collaborating-with-issues-and-pull-requests/index.md b/content/github/collaborating-with-issues-and-pull-requests/index.md
index 1e666ca019..51e6d15485 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/index.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/index.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md
index 876784f7cf..ffac83495b 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About pull request merges
diff --git a/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md
index 4463aa1477..d74e66d01c 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.command_line.open_the_multi_os_terminal %}
2. Change the current working directory to your local project.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/overview.md b/content/github/collaborating-with-issues-and-pull-requests/overview.md
index 816072556f..be470cec0b 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/overview.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/overview.md
@@ -6,5 +6,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md b/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md
index 913990858c..efe90d1598 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md b/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md
index 65ebb3844c..72ba7b1693 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Owners and collaborators on a repository owned by a user account can assign pull request reviews. Organization members with triage permissions to a repository can assign a pull request review.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
index ec47c6933b..a423d69817 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md
index 5dae3a1540..f97a0aa9fb 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Merge conflicts occur when competing changes are made to the same line of a file, or when one person edits a file and another person deletes the same file. For more information, see "[About merge conflicts](/articles/about-merge-conflicts/)."
diff --git a/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md
index dd7b4b5df1..2eeeb21d67 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About reverting a pull request
diff --git a/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md b/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md
index 83cbe91549..f0b03a1aae 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
index 2f68164e62..f925a1ee23 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
@@ -3,6 +3,8 @@ title: Reviewing dependency changes in a pull request
intro: 'If a pull request contains changes to dependencies, you can view a summary of what has changed and whether there are known vulnerabilities in any of the dependencies.'
versions:
free-pro-team: '*'
+topics:
+ - pull requests
---
{% note %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md
index efecceace8..0abbfff562 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About reviewing pull requests
diff --git a/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md b/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md
index affc3dd844..941f9b9da1 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Before you can sync your fork with an upstream repository, you must [configure a remote that points to the upstream repository](/articles/configuring-a-remote-for-a-fork) in Git.
diff --git a/content/github/collaborating-with-issues-and-pull-requests/viewing-a-pull-request-review.md b/content/github/collaborating-with-issues-and-pull-requests/viewing-a-pull-request-review.md
index 6beac48895..7eab837b12 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/viewing-a-pull-request-review.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/viewing-a-pull-request-review.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.search.requested_reviews_search %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md b/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md
index 28d3dee2e5..563ad76cfb 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.repositories.deleted_forks_from_private_repositories_warning %}
diff --git a/content/github/collaborating-with-issues-and-pull-requests/working-with-forks.md b/content/github/collaborating-with-issues-and-pull-requests/working-with-forks.md
index fef659dd91..0fca472b8f 100644
--- a/content/github/collaborating-with-issues-and-pull-requests/working-with-forks.md
+++ b/content/github/collaborating-with-issues-and-pull-requests/working-with-forks.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md b/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md
index 3b9fb08f27..2df075cbef 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-archiving-content-and-data-on-github
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
### Persistence of public repositories
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md
index 51d0fc1e32..829e7fffa7 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md
index c9da88109f..c65f2577a1 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
People with admin or owner permissions can set up a CODEOWNERS file in a repository.
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-readmes.md b/content/github/creating-cloning-and-archiving-repositories/about-readmes.md
index 2e65dc8587..c11e0278a7 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-readmes.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-readmes.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About READMEs
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/content/github/creating-cloning-and-archiving-repositories/about-repositories.md
index 214d30606e..87e8cbf1fd 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-repositories.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-repositories.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
You can own repositories individually, or you can share ownership of repositories with other people in an organization.
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md
index 94d1f82eb3..2fde93a169 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to
determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch.
diff --git a/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
index 9e2fc6a4ec..722ababce5 100644
--- a/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
+++ b/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About repository visibility
diff --git a/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md b/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md
index bb9d9e01a7..39ef8ed46e 100644
--- a/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md
@@ -10,5 +10,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md b/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md
index 8a8f7b9bdf..e7d866a63b 100644
--- a/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md
+++ b/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data reusables.repositories.archiving-repositories-recommendation %}
diff --git a/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
index ac898cfee5..8fd1c33c3f 100644
--- a/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md b/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md
index 8272d98dcb..e8b70b558f 100644
--- a/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md
+++ b/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md
index 0dc66db59f..8014777ecb 100644
--- a/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About cloning a repository
diff --git a/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md
index fbd4af8d7b..bdf453d842 100644
--- a/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md
@@ -13,6 +13,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% tip %}
diff --git a/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md
index c8174a611e..a5cb896023 100644
--- a/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md
+++ b/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About repository templates
diff --git a/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md b/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md
index ca3e328a93..ab4eaeb9cd 100644
--- a/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md
+++ b/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
index 39778d159c..786ce1022c 100644
--- a/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% note %}
diff --git a/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md b/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md
index 29b1a39280..c02192cb38 100644
--- a/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
1. Create a **private** repository to host the source code from your project.
diff --git a/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md b/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md
index bff96eedc7..69243b563c 100644
--- a/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Before you can duplicate a repository and push to your new copy, or _mirror_, of the repository, you must [create the new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. In these examples, `exampleuser/new-repository` or `exampleuser/mirrored` are the mirrors.
diff --git a/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md
index f1854f8be8..1f7017a371 100644
--- a/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md
+++ b/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Detecting this error is simple; Git will warn you when you try to clone the repository:
diff --git a/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md b/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md
index 55b0e571ce..b5a1a1591d 100644
--- a/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md
+++ b/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### Check your spelling
diff --git a/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md b/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md
index 5910f71320..8c1b1a9b6a 100644
--- a/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md
+++ b/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Here's an example of an HTTPS error you might receive:
diff --git a/content/github/creating-cloning-and-archiving-repositories/index.md b/content/github/creating-cloning-and-archiving-repositories/index.md
index d590e22a92..c5b3fb896f 100644
--- a/content/github/creating-cloning-and-archiving-repositories/index.md
+++ b/content/github/creating-cloning-and-archiving-repositories/index.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md
index 0110416cc7..aaf80f4d9a 100644
--- a/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - repositories
---
### Choosing the right license
diff --git a/content/github/creating-cloning-and-archiving-repositories/limits-for-viewing-content-and-diffs-in-a-repository.md b/content/github/creating-cloning-and-archiving-repositories/limits-for-viewing-content-and-diffs-in-a-repository.md
index 0a5310093a..1ebf7e51a8 100644
--- a/content/github/creating-cloning-and-archiving-repositories/limits-for-viewing-content-and-diffs-in-a-repository.md
+++ b/content/github/creating-cloning-and-archiving-repositories/limits-for-viewing-content-and-diffs-in-a-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Most of the limits below affect both {% data variables.product.product_name %} and the API.
diff --git a/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md b/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md
index 6bf832fcb6..be9786624d 100644
--- a/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md
+++ b/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/referencing-and-citing-content
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
### Issuing a persistent identifier for your repository with Zenodo
diff --git a/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md
index 22648b2242..c7553618ce 100644
--- a/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md
+++ b/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md
@@ -4,6 +4,8 @@ intro: 'When {% data variables.product.prodname_codespaces %} becomes generally
product: '{% data reusables.gated-features.codespaces %}'
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/about-codespaces.md b/content/github/developing-online-with-codespaces/about-codespaces.md
index c711a28763..133a2f95f3 100644
--- a/content/github/developing-online-with-codespaces/about-codespaces.md
+++ b/content/github/developing-online-with-codespaces/about-codespaces.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/about-github-codespaces
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% note %}
diff --git a/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md
index 07781dde1b..0c63b670ab 100644
--- a/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md
+++ b/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/configuring-github-codespaces-for-your-project
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/creating-a-codespace.md b/content/github/developing-online-with-codespaces/creating-a-codespace.md
index ff22cc9ec4..11f694ab41 100644
--- a/content/github/developing-online-with-codespaces/creating-a-codespace.md
+++ b/content/github/developing-online-with-codespaces/creating-a-codespace.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/creating-a-codespace
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/deleting-a-codespace.md b/content/github/developing-online-with-codespaces/deleting-a-codespace.md
index db9fe05a45..3479d7ede0 100644
--- a/content/github/developing-online-with-codespaces/deleting-a-codespace.md
+++ b/content/github/developing-online-with-codespaces/deleting-a-codespace.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/deleting-a-codespace
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/developing-in-a-codespace.md b/content/github/developing-online-with-codespaces/developing-in-a-codespace.md
index a9df2f093f..f40aa202bc 100644
--- a/content/github/developing-online-with-codespaces/developing-in-a-codespace.md
+++ b/content/github/developing-online-with-codespaces/developing-in-a-codespace.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/developing-in-a-codespace
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/index.md b/content/github/developing-online-with-codespaces/index.md
index 1ec4ada121..c0a39439e1 100644
--- a/content/github/developing-online-with-codespaces/index.md
+++ b/content/github/developing-online-with-codespaces/index.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces.md b/content/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces.md
index a364ad3050..1db7b63da3 100644
--- a/content/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces.md
+++ b/content/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces.md
@@ -4,6 +4,8 @@ intro: You can manage the repositories that codespaces can access.
product: '{% data reusables.gated-features.codespaces %}'
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% note %}
diff --git a/content/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces.md b/content/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces.md
index 2843a272a7..f99fc17ff1 100644
--- a/content/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces.md
+++ b/content/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces.md
@@ -1,9 +1,11 @@
---
title: Managing encrypted secrets for Codespaces
-intro: You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.
+intro: 'You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.'
product: '{% data reusables.gated-features.codespaces %}'
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% note %}
diff --git a/content/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces.md b/content/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces.md
index 41c3420829..2aeb8deb09 100644
--- a/content/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces.md
+++ b/content/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces.md
@@ -1,9 +1,11 @@
---
title: Managing GPG verification for Codespaces
-intro: You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.
+intro: 'You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.'
product: '{% data reusables.gated-features.codespaces %}'
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% note %}
diff --git a/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md b/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md
index 2539fd6762..57ec686acc 100644
--- a/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md
+++ b/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md b/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md
index 2daf7c2607..400c039188 100644
--- a/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md
+++ b/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/developing-online-with-github-codespaces/troubleshooting-your-codespace
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md
index cc973aea5e..a190ef1962 100644
--- a/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md
+++ b/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% data reusables.codespaces.release-stage %}
diff --git a/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md
index 64cedbedb9..084fc31a53 100644
--- a/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md
+++ b/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md
@@ -4,6 +4,8 @@ intro: 'You can develop in your codespace directly in {% data variables.product.
product: '{% data reusables.gated-features.codespaces %}'
versions:
free-pro-team: '*'
+topics:
+ - codespaces
---
{% note %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
index 93644fd985..8599ca24b2 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md
index 0e514fc25e..5869a83fc0 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md
index d8f88cd46b..cac898efaf 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
index c54a30bb93..26d4311360 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md
index b94bfc2fba..dae62003f2 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta-codeql-runner %}
@@ -35,12 +37,18 @@ To customize the way the {% data variables.product.prodname_codeql_runner %} sca
Scanning code whenever a pull request is created prevents developers from introducing new vulnerabilities and errors into the code.
-To scan a pull request, run the `analyze` command and use the `--ref` flag to specify the pull request. The reference is `refs/pull//head` or `refs/pull//merge`, depending on whether you have checked out the HEAD commit of the pull request branch or a merge commit with the base branch.
+To scan a pull request, run the `analyze` command and use the `--ref` flag to specify the pull request. The reference is `refs/pull//head` or `refs/pull//merge`, depending on whether you have checked out the HEAD commit of the pull request branch or a merge commit with the base branch.
```shell
-$ /path/to-runner/codeql-runner-linux analyze --ref refs/pull/42/head
+$ /path/to-runner/codeql-runner-linux analyze --ref refs/pull/42/merge
```
+{% note %}
+
+**Note**: If you analyze code with a third-party tool and want the results to appear as pull request checks, you must run the `upload` command and use the `--ref` flag to specify the pull request instead of the branch. The reference is `refs/pull//head` or `refs/pull//merge`.
+
+{% endnote %}
+
### Overriding automatic language detection
The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages.
@@ -110,7 +118,9 @@ If the `autobuild` command can't build your code, you can run the build steps yo
By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command.
-Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository)."
+Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository.
+- If you uploaded to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see "[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)."
+- If you uploaded to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see "[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository)."
### {% data variables.product.prodname_codeql_runner %} command reference
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md
index 3f9ef7ac04..99dabb5999 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md
index cf5bc1721e..3b6825a2db 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
### Table of Contents
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md
index ee5e4671d5..a463ffdbf6 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md
@@ -10,5 +10,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-a-container.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-a-container.md
index a05a2ca349..004c326f79 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-a-container.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-a-container.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md
index b2ff31219a..511d7205cd 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
@@ -98,6 +100,8 @@ To view the command-line reference for the runner, use the `-h` flag. For exampl
This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript).
+In this example, the server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository, so there is no need to use the `--codeql-path` flag.
+
1. Check out the repository to analyze.
1. Move into the directory where the repository is checked out.
1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected.
@@ -110,19 +114,7 @@ This example runs {% data variables.product.prodname_codeql %} analysis on a Lin
> Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript.
```
-1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}.
-
- ```shell
- $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo
- --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
- --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main
- > Finalizing database creation
- > ...
- > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms
- > Successfully uploaded results
- ```
-
-The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)."
+{% data reusables.code-scanning.codeql-runner-analyze-example %}
#### Compiled language example
@@ -139,8 +131,8 @@ This example is similar to the previous example, however this time the repositor
> ...
> CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json"
and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
- Please export these variables to future processes so that CodeQL can monitor the build, for example by running "
- . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
+ Please export these variables to future processes so that CodeQL can monitor the build, for example by running
+ ". /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
```
1. Source the script generated by the `init` action to set up the environment to monitor the build. Note the leading dot and space in the following code snippet.
@@ -151,17 +143,7 @@ This example is similar to the previous example, however this time the repositor
1. Build the code. On macOS, you need to prefix the build command with the environment variable `$CODEQL_RUNNER`. For more information, see "[Troubleshooting CodeQL code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system#no-code-found-during-the-build)."
-1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to {% data variables.product.prodname_dotcom %}.
-
- ```shell
- $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2
- --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
- --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main
- > Finalizing database creation
- > ...
- > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms
- > Successfully uploaded results
- ```
+{% data reusables.code-scanning.codeql-runner-analyze-example %}
{% note %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md
index eb3de38525..8bdd7005a8 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/setting-up-code-scanning-for-a-repository.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/setting-up-code-scanning-for-a-repository.md
index e7659aeb09..1046810c03 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/setting-up-code-scanning-for-a-repository.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/setting-up-code-scanning-for-a-repository.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md
index 496acb2802..1d93129def 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md
index 6a37da5f57..7fb5107e44 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta-codeql-runner %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md
index 5e1f031769..b88ddd1e4f 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
@@ -168,4 +170,4 @@ The revised `steps` section of the workflow will look like this:
...
```
-For more information about editing the {% data variables.product.prodname_codeql %} workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)."
\ No newline at end of file
+For more information about editing the {% data variables.product.prodname_codeql %} workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)."
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md
index a8908896f7..d8b31a6968 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
{% data reusables.code-scanning.beta %}
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md
index 942e66060b..685e815aea 100644
--- a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md
+++ b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - security
---
diff --git a/content/github/finding-talent-with-github-jobs/about-github-jobs.md b/content/github/finding-talent-with-github-jobs/about-github-jobs.md
index b828445961..f524f975c7 100644
--- a/content/github/finding-talent-with-github-jobs/about-github-jobs.md
+++ b/content/github/finding-talent-with-github-jobs/about-github-jobs.md
@@ -6,6 +6,8 @@ redirect_from:
intro: 'You can post a job on {% data variables.product.prodname_jobs %} to find talent for your business.'
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
Before you can post a job, you must create a {% data variables.product.prodname_dotcom %} account and verify your email address. For more information, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)" and "[Verifying your email address](/articles/verifying-your-email-address)."
diff --git a/content/github/finding-talent-with-github-jobs/index.md b/content/github/finding-talent-with-github-jobs/index.md
index 2ac9ca9b92..16bb315d08 100644
--- a/content/github/finding-talent-with-github-jobs/index.md
+++ b/content/github/finding-talent-with-github-jobs/index.md
@@ -6,6 +6,8 @@ redirect_from:
- /categories/finding-talent-with-github-jobs
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
diff --git a/content/github/getting-started-with-github/about-github-advanced-security.md b/content/github/getting-started-with-github/about-github-advanced-security.md
index f4e1f7ed53..89ae0113f8 100644
--- a/content/github/getting-started-with-github/about-github-advanced-security.md
+++ b/content/github/getting-started-with-github/about-github-advanced-security.md
@@ -1,15 +1,18 @@
---
title: About GitHub Advanced Security
-intro: '{% data variables.product.prodname_dotcom %} makes extra security features available to customers under an {% data variables.product.prodname_advanced_security %} license. These features are also enabled for public repositories on {% data variables.product.prodname_dotcom_the_website %}.'
+intro: '{% data variables.product.prodname_dotcom %} makes extra security features available to customers under an {% data variables.product.prodname_advanced_security %} license.{% if currentVersion == "free-pro-team@latest" %} These features are also enabled for public repositories on {% data variables.product.prodname_dotcom_the_website %}.{% endif %}'
+product: '{% data reusables.gated-features.ghas %}'
versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - security
---
### About {% data variables.product.prodname_GH_advanced_security %}
-{% data variables.product.prodname_dotcom %} has many features that help you improve and maintain the quality of your code. Some of these are included in all plans{% if currentVersion != "github-ae@latest" %}, such as dependency graph and {% data variables.product.prodname_dependabot_alerts %}{% endif %}. Other security features require a license for {% data variables.product.prodname_GH_advanced_security %} to run on repositories apart from public repositories on {% data variables.product.prodname_dotcom_the_website %}.
+{% data variables.product.prodname_dotcom %} has many features that help you improve and maintain the quality of your code. Some of these are included in all plans{% if currentVersion != "github-ae@latest" %}, such as dependency graph and {% data variables.product.prodname_dependabot_alerts %}{% endif %}. Other security features require a license for {% data variables.product.prodname_GH_advanced_security %} to run on repositories apart from public repositories on {% data variables.product.prodname_dotcom_the_website %}.
{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About licensing for {% data variables.product.prodname_GH_advanced_security %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security)."{% elsif currentVersion ver_gt "enterprise-server@2.22" %}For information about purchasing a license for {% data variables.product.prodname_GH_advanced_security %}, contact {% data variables.contact.contact_enterprise_sales %}.{% elsif currentVersion == "github-ae@latest" %}There is no charge for {% data variables.product.prodname_GH_advanced_security %} on {% data variables.product.prodname_ghe_managed %} during the beta release.{% endif %}
@@ -43,7 +46,7 @@ Once your system is set up, you can enable and disable these features at the org
For public repositories on {% data variables.product.prodname_dotcom_the_website %}, these features are permanently on and can only be disabled if you change the visibility of the project so that the code is no longer public.
-For other repositories, once you have a license for your organization or enterprise, you can enable and disable these features at the organization or repository level. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}For more information, see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" and "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %}
+For other repositories, once you have a license for your enterprise account, you can enable and disable these features at the organization or repository level. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}For more information, see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" and "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %}
{% endif %}
diff --git a/content/github/getting-started-with-github/access-permissions-on-github.md b/content/github/getting-started-with-github/access-permissions-on-github.md
index b2483b1986..bd8b6a4f51 100644
--- a/content/github/getting-started-with-github/access-permissions-on-github.md
+++ b/content/github/getting-started-with-github/access-permissions-on-github.md
@@ -10,6 +10,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - permissions
+ - accounts
---
### Personal user accounts
diff --git a/content/github/getting-started-with-github/be-social.md b/content/github/getting-started-with-github/be-social.md
index d326445068..2817ef122e 100644
--- a/content/github/getting-started-with-github/be-social.md
+++ b/content/github/getting-started-with-github/be-social.md
@@ -8,6 +8,12 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profile
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
To learn about accessing your personal dashboard, see "[About your personal dashboard](/articles/about-your-personal-dashboard)."
diff --git a/content/github/getting-started-with-github/create-a-repo.md b/content/github/getting-started-with-github/create-a-repo.md
index e04f4e2030..94477e922c 100644
--- a/content/github/getting-started-with-github/create-a-repo.md
+++ b/content/github/getting-started-with-github/create-a-repo.md
@@ -8,6 +8,11 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md b/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md
index caee1aa1eb..595962f3c5 100644
--- a/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md
+++ b/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/exploring-early-access-releases-with-feature-preview
versions:
free-pro-team: '*'
+topics:
+ - early access
---
### {% data variables.product.prodname_dotcom %}'s release cycle
diff --git a/content/github/getting-started-with-github/exploring-projects-on-github.md b/content/github/getting-started-with-github/exploring-projects-on-github.md
index 796214bfb5..86b64226f4 100644
--- a/content/github/getting-started-with-github/exploring-projects-on-github.md
+++ b/content/github/getting-started-with-github/exploring-projects-on-github.md
@@ -11,5 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - projects
---
diff --git a/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md b/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md
index 6d85fbd4f0..c9bba505fd 100644
--- a/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md
+++ b/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md
@@ -3,6 +3,8 @@ title: FAQ about changes to GitHub’s plans
intro: 'As of April 14, 2020, GitHub announced that all of the core GitHub features are now free for everyone.'
versions:
free-pro-team: '*'
+topics:
+ - github
---
### What plans and pricing changes did GitHub announce on April 14?
diff --git a/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md b/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md
index d1b5e3c6c9..46760bbc07 100644
--- a/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md
+++ b/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md
@@ -10,6 +10,8 @@ redirect_from:
- /github/getting-started-with-github/finding-open-source-projects-on-github
versions:
free-pro-team: '*'
+topics:
+ - open source
---
### Discovering relevant projects
diff --git a/content/github/getting-started-with-github/following-people.md b/content/github/getting-started-with-github/following-people.md
index cbf380c4a0..c629d18751 100644
--- a/content/github/getting-started-with-github/following-people.md
+++ b/content/github/getting-started-with-github/following-people.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profile
---
When you follow people, you'll see their public activity in the activity view of your news feed.{% if currentVersion == "free-pro-team@latest" %} If someone you follow stars a public repository, {% data variables.product.product_name %} may recommend the repository to you in the discovery view of your news feed.{% endif %} To follow someone, visit their profile page and click **Follow** under their profile image.
diff --git a/content/github/getting-started-with-github/fork-a-repo.md b/content/github/getting-started-with-github/fork-a-repo.md
index 74914f4ea5..777773290a 100644
--- a/content/github/getting-started-with-github/fork-a-repo.md
+++ b/content/github/getting-started-with-github/fork-a-repo.md
@@ -9,6 +9,11 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
Most commonly, forks are used to either propose changes to someone else's project or to use someone else's project as a starting point for your own idea.
diff --git a/content/github/getting-started-with-github/github-cli.md b/content/github/getting-started-with-github/github-cli.md
index 9abdb36159..ff68b7c922 100644
--- a/content/github/getting-started-with-github/github-cli.md
+++ b/content/github/getting-started-with-github/github-cli.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>2.19'
github-ae: '*'
+topics:
+ - cli
---
### About {% data variables.product.prodname_cli %}
diff --git a/content/github/getting-started-with-github/github-desktop.md b/content/github/getting-started-with-github/github-desktop.md
index bce85ea84e..cfb8affbb7 100644
--- a/content/github/getting-started-with-github/github-desktop.md
+++ b/content/github/getting-started-with-github/github-desktop.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - desktop
---
### About {% data variables.product.prodname_desktop %}
diff --git a/content/github/getting-started-with-github/github-for-mobile.md b/content/github/getting-started-with-github/github-for-mobile.md
index 1a0fc38c53..13e7496742 100644
--- a/content/github/getting-started-with-github/github-for-mobile.md
+++ b/content/github/getting-started-with-github/github-for-mobile.md
@@ -4,6 +4,8 @@ intro: 'Triage, collaborate, and manage your work on {% data variables.product.p
versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
+topics:
+ - mobile
---
{% data reusables.mobile.ghes-release-phase %}
diff --git a/content/github/getting-started-with-github/githubs-products.md b/content/github/getting-started-with-github/githubs-products.md
index 4f14fddd35..8a162bbf28 100644
--- a/content/github/getting-started-with-github/githubs-products.md
+++ b/content/github/getting-started-with-github/githubs-products.md
@@ -8,6 +8,12 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - cli
+ - mobile
+ - desktop
+ - security
---
{% data variables.product.prodname_dotcom %} offers free and paid products. You can see pricing and a full list of features for each product at <{% data variables.product.pricing_url %}>. {% data reusables.products.product-roadmap %}
@@ -79,7 +85,8 @@ In addition to the features available with {% data variables.product.prodname_te
- Additional security, compliance, and deployment controls
- Authentication with SAML single sign-on
- Access provisioning with SAML or SCIM
-- {% data variables.product.prodname_github_connect %}
+- {% data variables.product.prodname_github_connect %}{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+- The option to purchase {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/github/getting-started-with-github/about-github-advanced-security)."{% endif %}
{% data variables.product.prodname_ghe_cloud %} also includes:
- {% data variables.contact.enterprise_support %}. For more information, see "{% data variables.product.prodname_ghe_cloud %} support" and "{% data variables.product.prodname_ghe_cloud %} Addendum."
diff --git a/content/github/getting-started-with-github/index.md b/content/github/getting-started-with-github/index.md
index f3f4596e9e..184a5a0296 100644
--- a/content/github/getting-started-with-github/index.md
+++ b/content/github/getting-started-with-github/index.md
@@ -34,6 +34,11 @@ featuredLinks:
- /github/getting-started-with-github/types-of-github-accounts
- /github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github
- /github/getting-started-with-github/troubleshooting-connectivity-problems
+topics:
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
diff --git a/content/github/getting-started-with-github/learning-about-github.md b/content/github/getting-started-with-github/learning-about-github.md
index 8c94a8491f..d43ab528ff 100644
--- a/content/github/getting-started-with-github/learning-about-github.md
+++ b/content/github/getting-started-with-github/learning-about-github.md
@@ -8,5 +8,11 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - cli
+ - mobile
+ - desktop
+ - security
---
diff --git a/content/github/getting-started-with-github/quickstart.md b/content/github/getting-started-with-github/quickstart.md
index 77de003bdf..d123093cb0 100644
--- a/content/github/getting-started-with-github/quickstart.md
+++ b/content/github/getting-started-with-github/quickstart.md
@@ -6,5 +6,10 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
diff --git a/content/github/getting-started-with-github/saving-repositories-with-stars.md b/content/github/getting-started-with-github/saving-repositories-with-stars.md
index 993595cb4e..2cbf15688c 100644
--- a/content/github/getting-started-with-github/saving-repositories-with-stars.md
+++ b/content/github/getting-started-with-github/saving-repositories-with-stars.md
@@ -11,6 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
You can search, sort, and filter your starred repositories and topics on your {% data variables.explore.your_stars_page %}.'
diff --git a/content/github/getting-started-with-github/set-up-git.md b/content/github/getting-started-with-github/set-up-git.md
index 3e1169f8e4..e96c3b8490 100644
--- a/content/github/getting-started-with-github/set-up-git.md
+++ b/content/github/getting-started-with-github/set-up-git.md
@@ -15,6 +15,11 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
+ - issues
+ - notifications
+ - accounts
---
To use Git on the command line, you'll need to download, install, and configure Git on your computer. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %} You can also install {% data variables.product.prodname_cli %} to use {% data variables.product.product_name %} from the command line. For more information on {% data variables.product.prodname_cli %}, see the [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) documentation.{% endif %}
diff --git a/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md b/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md
index 46ae74fe24..3105c872d2 100644
--- a/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md
+++ b/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md
@@ -6,6 +6,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
---
### About trials of {% data variables.product.prodname_ghe_cloud %}
diff --git a/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md b/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md
index d0d75deba7..8800cbbc3f 100644
--- a/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md
+++ b/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
---
### About trials of {% data variables.product.prodname_ghe_server %}
diff --git a/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md b/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md
index f30f496882..fa3b49af14 100644
--- a/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md
+++ b/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/signing-up-for-a-new-github-account
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
For more information about account types and products, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/articles/types-of-github-accounts)" and "[{% data variables.product.product_name %}'s products](/articles/github-s-products)."
diff --git a/content/github/getting-started-with-github/signing-up-for-github.md b/content/github/getting-started-with-github/signing-up-for-github.md
index 540b8e845c..b231d472ab 100644
--- a/content/github/getting-started-with-github/signing-up-for-github.md
+++ b/content/github/getting-started-with-github/signing-up-for-github.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
diff --git a/content/github/getting-started-with-github/types-of-github-accounts.md b/content/github/getting-started-with-github/types-of-github-accounts.md
index 17235a2455..f1615b90b7 100644
--- a/content/github/getting-started-with-github/types-of-github-accounts.md
+++ b/content/github/getting-started-with-github/types-of-github-accounts.md
@@ -11,6 +11,12 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - cli
+ - mobile
+ - desktop
+ - security
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/getting-started-with-github/verifying-your-email-address.md b/content/github/getting-started-with-github/verifying-your-email-address.md
index f4a31c5d35..71f4415c43 100644
--- a/content/github/getting-started-with-github/verifying-your-email-address.md
+++ b/content/github/getting-started-with-github/verifying-your-email-address.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/verifying-your-email-address
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
### About email verification
diff --git a/content/github/managing-files-in-a-repository/3d-file-viewer.md b/content/github/managing-files-in-a-repository/3d-file-viewer.md
index c203f9b71d..f1b6595e4a 100644
--- a/content/github/managing-files-in-a-repository/3d-file-viewer.md
+++ b/content/github/managing-files-in-a-repository/3d-file-viewer.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data variables.product.product_name %} can host and render 3D files with the *.stl* extension.
diff --git a/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md
index 2f0fc63c9a..b4ec09487f 100644
--- a/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md
+++ b/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% tip %}
diff --git a/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md b/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md
index 2b87bdf54e..62e57a8f86 100644
--- a/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md
+++ b/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Files that you add to a repository via a browser are limited to {% data variables.large_files.max_github_browser_size %} per file. You can add larger files, up to {% data variables.large_files.max_github_size %} each, via the command line. For more information, see "[Adding a file to a repository using the command line](/articles/adding-a-file-to-a-repository-using-the-command-line)."
diff --git a/content/github/managing-files-in-a-repository/creating-new-files.md b/content/github/managing-files-in-a-repository/creating-new-files.md
index 4f625eff34..9f3b073d39 100644
--- a/content/github/managing-files-in-a-repository/creating-new-files.md
+++ b/content/github/managing-files-in-a-repository/creating-new-files.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
When creating a file on {% data variables.product.product_name %}, consider the following:
diff --git a/content/github/managing-files-in-a-repository/deleting-files-in-a-repository.md b/content/github/managing-files-in-a-repository/deleting-files-in-a-repository.md
index 40bcfcc02e..163a2a447b 100644
--- a/content/github/managing-files-in-a-repository/deleting-files-in-a-repository.md
+++ b/content/github/managing-files-in-a-repository/deleting-files-in-a-repository.md
@@ -9,7 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
-permissions: People with write permissions can delete files{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} or directories{% endif %} in a repository.
+permissions: 'People with write permissions can delete files{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} or directories{% endif %} in a repository.'
+topics:
+ - repositories
---
### About file{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} and directory{% endif %} deletion
@@ -40,4 +42,4 @@ If the file{% if currentVersion == "free-pro-team@latest" or currentVersion ver_
{% data reusables.files.choose-commit-email %}
{% data reusables.files.choose_commit_branch %}
{% data reusables.files.propose_file_change %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/content/github/managing-files-in-a-repository/editing-files-in-another-users-repository.md b/content/github/managing-files-in-a-repository/editing-files-in-another-users-repository.md
index dc10c8e09f..21cf61f245 100644
--- a/content/github/managing-files-in-a-repository/editing-files-in-another-users-repository.md
+++ b/content/github/managing-files-in-a-repository/editing-files-in-another-users-repository.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
1. In another user's repository, browse to the folder that contains the file you want to edit. Click the name of the file you want to edit.
diff --git a/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md b/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md
index 5de63217e7..94bebe636a 100644
--- a/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md
+++ b/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% tip %}
diff --git a/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md
index 756ff937e0..e1e9942b61 100644
--- a/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md
+++ b/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% tip %}
diff --git a/content/github/managing-files-in-a-repository/index.md b/content/github/managing-files-in-a-repository/index.md
index faf07b3fb4..c17ebfd9e9 100644
--- a/content/github/managing-files-in-a-repository/index.md
+++ b/content/github/managing-files-in-a-repository/index.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/managing-files-in-a-repository/managing-files-on-github.md b/content/github/managing-files-in-a-repository/managing-files-on-github.md
index da52349c22..847cc2c4f7 100644
--- a/content/github/managing-files-in-a-repository/managing-files-on-github.md
+++ b/content/github/managing-files-in-a-repository/managing-files-on-github.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md b/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md
index 1badad1949..4e9a2a76e5 100644
--- a/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md
+++ b/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md b/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md
index 863ba4e52d..909b0152ec 100644
--- a/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md
+++ b/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% data variables.product.product_name %} supports rendering geoJSON and topoJSON map files within {% data variables.product.product_name %} repositories. Simply commit the file as you would normally using a `.geojson` or `.topojson` extension. Files with a `.json` extension are also supported, but only if `type` is set to `FeatureCollection`, `GeometryCollection`, or `topology`. Then, navigate to the path of the geoJSON file on GitHub.com.
diff --git a/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md b/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md
index 7479f99231..cdabc716cb 100644
--- a/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md
+++ b/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Many files can be [moved directly on {% data variables.product.product_name %}](/articles/moving-a-file-to-a-new-location), but some files, such as images, require that you move them from the command line.
diff --git a/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md b/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md
index c628d64080..4a1f31ec2e 100644
--- a/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md
+++ b/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
In addition to changing the file location, you can also [update the contents of your file](/articles/editing-files-in-your-repository), or [give it a new name](/articles/renaming-a-file) in the same commit.
diff --git a/content/github/managing-files-in-a-repository/navigating-code-on-github.md b/content/github/managing-files-in-a-repository/navigating-code-on-github.md
index 82b3f3ecc8..693ce8c7cf 100644
--- a/content/github/managing-files-in-a-repository/navigating-code-on-github.md
+++ b/content/github/managing-files-in-a-repository/navigating-code-on-github.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/navigating-code-on-github
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
### About navigating code on {% data variables.product.prodname_dotcom %}
diff --git a/content/github/managing-files-in-a-repository/renaming-a-file-using-the-command-line.md b/content/github/managing-files-in-a-repository/renaming-a-file-using-the-command-line.md
index 213d83c124..3477c51b80 100644
--- a/content/github/managing-files-in-a-repository/renaming-a-file-using-the-command-line.md
+++ b/content/github/managing-files-in-a-repository/renaming-a-file-using-the-command-line.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Many files can be [renamed directly on {% data variables.product.product_name %}](/articles/renaming-a-file), but some files, such as images, require that you rename them from the command line.
diff --git a/content/github/managing-files-in-a-repository/renaming-a-file.md b/content/github/managing-files-in-a-repository/renaming-a-file.md
index c516722bcb..6b95200340 100644
--- a/content/github/managing-files-in-a-repository/renaming-a-file.md
+++ b/content/github/managing-files-in-a-repository/renaming-a-file.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% tip %}
diff --git a/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md b/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md
index 5f4a5868b0..cbb171c5b3 100644
--- a/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md
+++ b/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% note %}
diff --git a/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md b/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md
index 216d9abe4f..426afc055d 100644
--- a/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md
+++ b/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
GitHub supports rendering tabular data in the form of *.csv* (comma-separated) and .*tsv* (tab-separated) files.
diff --git a/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md b/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md
index 1f3c59ad20..2a547a058b 100644
--- a/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md
+++ b/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Commits and pull requests that include prose documents have the ability to represent those documents with *source* and *rendered* views.
diff --git a/content/github/managing-files-in-a-repository/rendering-pdf-documents.md b/content/github/managing-files-in-a-repository/rendering-pdf-documents.md
index 5e13b3f24a..11567a5abd 100644
--- a/content/github/managing-files-in-a-repository/rendering-pdf-documents.md
+++ b/content/github/managing-files-in-a-repository/rendering-pdf-documents.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
GitHub supports rendering of PDF documents.
diff --git a/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md b/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md
index 99fb0d7b54..9ace4fd76b 100644
--- a/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md
+++ b/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
With the blame view, you can view the line-by-line revision history for an entire file, or view the revision history of a single line within a file by clicking {% octicon "versions" aria-label="The prior blame icon" %}. Each time you click {% octicon "versions" aria-label="The prior blame icon" %}, you'll see the previous revision information for that line, including who committed the change and when.
diff --git a/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md
index be3704331a..60e0292cb6 100644
--- a/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md
+++ b/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/managing-files-in-a-repository/working-with-non-code-files.md b/content/github/managing-files-in-a-repository/working-with-non-code-files.md
index 2fb771ab50..2632f39bf4 100644
--- a/content/github/managing-files-in-a-repository/working-with-non-code-files.md
+++ b/content/github/managing-files-in-a-repository/working-with-non-code-files.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
index 1fdc443166..34402e25b6 100644
--- a/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
+++ b/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - security
---
### About vulnerable dependencies
diff --git a/content/github/managing-security-vulnerabilities/about-dependabot-security-updates.md b/content/github/managing-security-vulnerabilities/about-dependabot-security-updates.md
index 932ce92e86..c5b8113b3a 100644
--- a/content/github/managing-security-vulnerabilities/about-dependabot-security-updates.md
+++ b/content/github/managing-security-vulnerabilities/about-dependabot-security-updates.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/about-github-dependabot-security-updates
versions:
free-pro-team: '*'
+topics:
+ - security
---
### About {% data variables.product.prodname_dependabot_security_updates %}
@@ -40,4 +42,4 @@ When you merge a pull request that contains a security update, the corresponding
### About notifications for {% data variables.product.prodname_dependabot %} security updates
-You can filter your notifications on {% data variables.product.company_short %} to show {% data variables.product.prodname_dependabot %} security updates. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)."
\ No newline at end of file
+You can filter your notifications on {% data variables.product.company_short %} to show {% data variables.product.prodname_dependabot %} security updates. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#dependabot-custom-filters)."
diff --git a/content/github/managing-security-vulnerabilities/about-github-security-advisories.md b/content/github/managing-security-vulnerabilities/about-github-security-advisories.md
index f1c2841e3b..4ddb6196d2 100644
--- a/content/github/managing-security-vulnerabilities/about-github-security-advisories.md
+++ b/content/github/managing-security-vulnerabilities/about-github-security-advisories.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/about-maintainer-security-advisories
versions:
free-pro-team: '*'
+topics:
+ - security
---
{% data reusables.repositories.security-advisory-admin-permissions %}
diff --git a/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md b/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md
index 9041daa8de..2d5b72356a 100644
--- a/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md
+++ b/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md
@@ -3,6 +3,8 @@ title: About managing vulnerable dependencies
intro: '{% data variables.product.prodname_dotcom %} helps you to avoid using third-party software that contains known vulnerabilities.'
versions:
free-pro-team: '*'
+topics:
+ - security
---
{% data variables.product.prodname_dotcom %} provides the following tools for removing and avoiding vulnerable dependencies.
diff --git a/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md b/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md
index c182035648..eae7a3aedc 100644
--- a/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/adding-a-collaborator-to-a-maintainer-security-advisory
versions:
free-pro-team: '*'
+topics:
+ - security
---
People with admin permissions to a security advisory can add collaborators to the security advisory.
diff --git a/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md b/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md
index 874073caaa..1b0d31f33c 100644
--- a/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md
+++ b/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/adding-a-security-policy-to-your-repository
versions:
free-pro-team: '*'
+topics:
+ - security
---
### About security policies
diff --git a/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md b/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md
index a45c3564bf..12d047bb37 100644
--- a/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md
+++ b/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md
@@ -4,6 +4,8 @@ intro: 'The {% data variables.product.prodname_advisory_database %} allows you t
shortTitle: Browsing the Advisory Database
versions:
free-pro-team: '*'
+topics:
+ - security
---
### About security vulnerabilities
diff --git a/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md b/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md
index fb5e8e5a95..b4961194c4 100644
--- a/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md
+++ b/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability
versions:
free-pro-team: '*'
+topics:
+ - security
---
### Prerequisites
diff --git a/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md b/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md
index c1ae6ff87f..55c9e8a0b5 100644
--- a/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md
+++ b/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md
@@ -9,6 +9,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates
versions:
free-pro-team: '*'
+topics:
+ - security
---
### About configuring {% data variables.product.prodname_dependabot_security_updates %}
diff --git a/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md b/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md
index b1097a9342..c894222439 100644
--- a/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md
+++ b/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md
@@ -5,6 +5,8 @@ intro: 'Optimize how you receive notifications about {% if currentVersion == "f
versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
+topics:
+ - security
---
### About notifications for vulnerable dependencies
diff --git a/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md b/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md
index fd713c6afb..983020feec 100644
--- a/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/creating-a-maintainer-security-advisory
versions:
free-pro-team: '*'
+topics:
+ - security
---
Anyone with admin permissions to a repository can create a security advisory.
diff --git a/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md b/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md
index d2914ae576..c60b339d43 100644
--- a/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md
@@ -3,6 +3,8 @@ title: Editing a security advisory
intro: You can edit the metadata and description for a security advisory if you need to update details or correct errors.
versions:
free-pro-team: '*'
+topics:
+ - security
---
People with admin permissions to a security advisory can edit the security advisory.
diff --git a/content/github/managing-security-vulnerabilities/index.md b/content/github/managing-security-vulnerabilities/index.md
index 9afde0213a..ee2fd3d8ae 100644
--- a/content/github/managing-security-vulnerabilities/index.md
+++ b/content/github/managing-security-vulnerabilities/index.md
@@ -5,6 +5,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - security
---
diff --git a/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md b/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md
index 85d0c898be..145fe1516d 100644
--- a/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md
+++ b/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md
@@ -10,5 +10,7 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - security
---
diff --git a/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md b/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md
index a69030e7e2..80d91731a9 100644
--- a/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md
+++ b/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/permission-levels-for-maintainer-security-advisories
versions:
free-pro-team: '*'
+topics:
+ - security
---
### Permissions overview
diff --git a/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md b/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md
index cde49eaca0..511a9bff69 100644
--- a/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/publishing-a-maintainer-security-advisory
versions:
free-pro-team: '*'
+topics:
+ - security
---
Anyone with admin permissions to a security advisory can publish the security advisory.
diff --git a/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md b/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md
index ff06ba0cb0..d3e2fbfb3d 100644
--- a/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md
@@ -3,6 +3,8 @@ title: Removing a collaborator from a security advisory
intro: 'When you remove a collaborator from a security advisory, they lose read and write access to the security advisory''s discussion and metadata.'
versions:
free-pro-team: '*'
+topics:
+ - security
---
People with admin permissions to a security advisory can remove collaborators from the security advisory.
diff --git a/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md b/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md
index 0867da11f0..fa7dcb49d7 100644
--- a/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md
+++ b/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/managing-security-vulnerabilities/troubleshooting-github-dependabot-errors
versions:
free-pro-team: '*'
+topics:
+ - security
---
{% data reusables.dependabot.beta-note %}
diff --git a/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md b/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md
index ce6fe1bc8e..91aac50f13 100644
--- a/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md
+++ b/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md
@@ -4,6 +4,8 @@ intro: 'If the dependency information reported by {% data variables.product.prod
shortTitle: Troubleshooting detection
versions:
free-pro-team: '*'
+topics:
+ - security
---
The results of dependency detection reported by {% data variables.product.product_name %} may be different from the results returned by other tools. There are good reasons for this and it's helpful to understand how {% data variables.product.prodname_dotcom %} determines dependencies for your project.
diff --git a/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md b/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md
index 532fddecb5..c1c2a5ea52 100644
--- a/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md
+++ b/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md
@@ -7,6 +7,8 @@ permissions: Repository administrators and organization owners can view and upda
shortTitle: Viewing and updating vulnerable dependencies
versions:
free-pro-team: '*'
+topics:
+ - security
---
Your repository's {% data variables.product.prodname_dependabot %} alerts tab lists all open and closed {% data variables.product.prodname_dependabot_alerts %} and corresponding {% data variables.product.prodname_dependabot_security_updates %}. You can sort the list of alerts using the drop-down menu, and you can click into specific alerts for more details. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."
diff --git a/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md b/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md
index 90e0dd0d99..3c83e17230 100644
--- a/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md
+++ b/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md
@@ -3,6 +3,8 @@ title: Withdrawing a security advisory
intro: You can withdraw a security advisory that you've published.
versions:
free-pro-team: '*'
+topics:
+ - security
---
If you publish a security advisory in error, you can withdraw the security advisory by contacting {% data variables.contact.contact_support %}.
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md
index b10f85762d..e7b5a97ca3 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
{% if enterpriseServerVersions contains currentVersion %}
@@ -63,7 +65,7 @@ To keep your subscriptions manageable, review your subscriptions and watched rep
To customize how you'd like to receive updates for specific pull requests or issues, you can configure your preferences within the issue or pull request. For more information, see “[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).”
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22"%}
-You can enable push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)."
+You can customize and schedule push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#managing-your-notification-settings-with-github-for-mobile)."
{% endif %}
### Reasons for receiving notifications
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md
index 64f25bd77b..d6ab248414 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md
@@ -17,6 +17,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
{% if enterpriseServerVersions contains currentVersion %}
@@ -50,7 +52,7 @@ The notifications inbox on {% data variables.product.product_name %}{% if curren
- Group notifications in your inbox by repository or date to get a quick overview with less context switching
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %}
-In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)."
+In addition, you can receive and triage notifications on your mobile device with {% data variables.product.prodname_mobile %}. For more information, see "[Managing your notification settings with GitHub for mobile](#managing-your-notification-settings-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)."
{% endif %}
#### Benefits of using an email client for notifications
@@ -63,7 +65,7 @@ Email notifications also allow flexibility with the types of notifications you r
### About participating and watching notifications
-When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. For more information, see "[About team discussions](/github/building-a-strong-community/about-team-discussions)."
+When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
To see repositories that you're watching, go to your [watching page](https://github.com/watching). For more information, see "[Managing subscriptions and notifications on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)."
{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
@@ -152,6 +154,26 @@ By default, anytime you gain access to a new repository, you will automatically
If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option.
+### Configuring your watch settings for an individual repository
+
+You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
+
+{% data reusables.repositories.navigate-to-repo %}
+2. In the upper-right corner, click the "Watch" drop-down menu to select a watch option.
+{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
+ 
+{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}
+ 
+{% data reusables.notifications-v2.custom-notifications-beta %}
+The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions.
+
+ 
+
+If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues.
+
+{% endif %}
+
### Choosing where your organization’s email notifications are sent
If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address.
@@ -200,28 +222,41 @@ Choose how you want to receive workflow run updates for repositories that you ar
{% endif %}
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %}
-### Enabling push notifications with {% data variables.product.prodname_mobile %}
+### Managing your notification settings with {% data variables.product.prodname_mobile %}
-When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app.
+When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. Within the app, you can enable push notifications for the following events.
+- Direct mentions
+- Assignments to issues or pull requests
+- Requests to review a pull request
+- Requests to approve a deployment
-You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time.
+You can also schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device.
{% data reusables.mobile.push-notifications-on-ghes %}
-#### Enabling push notifications with {% data variables.product.prodname_ios %}
+#### Managing your notification settings with {% data variables.product.prodname_ios %}
-1. Above "Home", tap your profile photo.
+1. In the bottom menu, tap **Profile**.
2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}.
- 
-3. To update your notification settings, tap **Push notifications**.
-4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle.
+3. To update your notification settings, tap **Notifications** and then use the toggles to enable or disable your preferred types of push notifications.
+4. Optionally, to schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device, tap **Working Hours**, use the **Custom working hours** toggle, and then choose when you would like to receive push notifications.
-{% if currentVersion == "free-pro-team@latest" %}
-#### Enabling push notifications with {% data variables.product.prodname_android %}
+#### Managing your notification settings with {% data variables.product.prodname_android %}
-1. Above "Home", tap your profile photo.
+1. In the bottom menu, tap **Profile**.
2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}.
- 
-3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle.
+3. To update your notification settings, tap **Notifications** and then use the toggles to enable or disable your preferred types of push notifications.
+4. Optionally, to schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device, tap **Receive Notifications**, use the **Custom working hours** toggle, and then choose when you would like to receive push notifications.
+
+### Configuring your watch settings for an individual repository with {% data variables.product.prodname_mobile %}
+
+You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
+
+1. On {% data variables.product.prodname_mobile %}, navigate to main page of the repository.
+2. Tap **Watch**.
+ 
+3. To choose what activities you receive notifications for, tap your preferred watch settings.
+ 
+{% data reusables.notifications-v2.custom-notifications-beta %}
+
{% endif %}
-{% endif %}
\ No newline at end of file
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md b/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md
index 8a458d1456..bfc6a6038a 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
### Starting your inbox triage
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/index.md b/content/github/managing-subscriptions-and-notifications-on-github/index.md
index ed54e4ee58..2ac3e96335 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/index.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/index.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
### Table of Contents
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md
index 5e5c8949b4..506a577ecf 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
{% if enterpriseServerVersions contains currentVersion %}
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md b/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md
index 57f54410c0..4783be44f1 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md
@@ -6,5 +6,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md
index d947f274cb..41501f058e 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
To help you understand your subscriptions and decide whether to unsubscribe, see "[Viewing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions)."
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md b/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md
index ba87f0c7c0..7995dcba50 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md b/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md
index a6210db1b2..6214d8b1ea 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
### Saving a single notification
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md b/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md
index 761e8487ea..1d23e517b8 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
diff --git a/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md b/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md
index fa4321a743..bdc6a0d93b 100644
--- a/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md
+++ b/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md
@@ -18,6 +18,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.21'
github-ae: '*'
+topics:
+ - notifications
---
You receive notifications for your subscriptions of ongoing activity on {% data variables.product.product_name %}. There are many reasons you can be subscribed to a conversation. For more information, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notifications-and-subscriptions)."
@@ -81,23 +83,3 @@ Many people forget about repositories that they've chosen to watch in the past.
When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned.
{% endtip %}
-
-### Configuring your watch settings for an individual repository
-
-You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
-
-{% data reusables.repositories.navigate-to-repo %}
-2. In the upper-right corner, click the "Watch" drop-down menu to select a watch option.
-{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
- 
-{% endif %}
-{% if currentVersion == "free-pro-team@latest" %}
- 
-{% data reusables.notifications-v2.custom-notifications-beta %}
-The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions.
-
- 
-
-If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues.
-
-{% endif %}
diff --git a/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md
index 39b913c7c2..010c9aea63 100644
--- a/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md
+++ b/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Query parameters are optional parts of a URL you can customize to share a specific web page view, such as search filter results or an issue template on {% data variables.product.prodname_dotcom %}. To create your own query parameters, you must match the key and value pair.
diff --git a/content/github/managing-your-work-on-github/about-automation-for-project-boards.md b/content/github/managing-your-work-on-github/about-automation-for-project-boards.md
index 1a6b04071a..1fcade4aa0 100644
--- a/content/github/managing-your-work-on-github/about-automation-for-project-boards.md
+++ b/content/github/managing-your-work-on-github/about-automation-for-project-boards.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.project-management.automate-project-board-permissions %} For more information, see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)."
diff --git a/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md
index f1b544a094..9f7ec04b68 100644
--- a/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
For a "marked as duplicate" timeline event to appear, the user who creates the duplicate reference comment must have write access to the repository where they create the comment.
diff --git a/content/github/managing-your-work-on-github/about-issues.md b/content/github/managing-your-work-on-github/about-issues.md
index 9500408071..fee3c09c34 100644
--- a/content/github/managing-your-work-on-github/about-issues.md
+++ b/content/github/managing-your-work-on-github/about-issues.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About issues
diff --git a/content/github/managing-your-work-on-github/about-milestones.md b/content/github/managing-your-work-on-github/about-milestones.md
index 27238a9b73..2b3ae8c27f 100644
--- a/content/github/managing-your-work-on-github/about-milestones.md
+++ b/content/github/managing-your-work-on-github/about-milestones.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you [create a milestone](/articles/creating-and-editing-milestones-for-issues-and-pull-requests), you can [associate it with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests).
diff --git a/content/github/managing-your-work-on-github/about-project-boards.md b/content/github/managing-your-work-on-github/about-project-boards.md
index da22dbe579..69c4caa8fc 100644
--- a/content/github/managing-your-work-on-github/about-project-boards.md
+++ b/content/github/managing-your-work-on-github/about-project-boards.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Project boards are made up of issues, pull requests, and notes that are categorized as cards in columns of your choosing. You can drag and drop or use keyboard shortcuts to reorder cards within a column, move cards from column to column, and change the order of columns.
diff --git a/content/github/managing-your-work-on-github/about-task-lists.md b/content/github/managing-your-work-on-github/about-task-lists.md
index 250c4684a9..d0407d4813 100644
--- a/content/github/managing-your-work-on-github/about-task-lists.md
+++ b/content/github/managing-your-work-on-github/about-task-lists.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Task lists render with clickable checkboxes in comments. You can select or unselect the checkboxes to mark them as complete or incomplete.
diff --git a/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md
index 028e0c5031..89d954f6b8 100644
--- a/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md
+++ b/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can add issue or pull request cards to your project board by:
diff --git a/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md b/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md
index 87761cc8b8..1361bcea63 100644
--- a/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md
+++ b/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% tip %}
diff --git a/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md b/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md
index cc7eb1dd66..b6b513b8cf 100644
--- a/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md
+++ b/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Automation in your project board does not apply to archived project board cards. For example, if you close an issue in a project board's archive, the archived card does not automatically move to the "Done" column. When you restore a card from the project board archive, the card will return to the column where it was archived.
diff --git a/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md
index c9feda552b..d3704545bb 100644
--- a/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md
+++ b/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Anyone with write permissions to a repository can assign issues and pull requests.
diff --git a/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md
index 73f110edab..2b6bc1cbda 100644
--- a/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/managing-your-work-on-github/changing-project-board-visibility.md b/content/github/managing-your-work-on-github/changing-project-board-visibility.md
index 0ecd5477f4..34b68877bd 100644
--- a/content/github/managing-your-work-on-github/changing-project-board-visibility.md
+++ b/content/github/managing-your-work-on-github/changing-project-board-visibility.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.project-management.project-board-visibility %}
diff --git a/content/github/managing-your-work-on-github/closing-a-project-board.md b/content/github/managing-your-work-on-github/closing-a-project-board.md
index 57b8586d71..5d0f001f70 100644
--- a/content/github/managing-your-work-on-github/closing-a-project-board.md
+++ b/content/github/managing-your-work-on-github/closing-a-project-board.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you close a project board, any configured workflow automation will pause by default.
diff --git a/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md b/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md
index 037b6efa7c..7289b952f4 100644
--- a/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md
+++ b/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.project-management.automate-project-board-permissions %} For more information, see "[About automation for project boards](/articles/about-automation-for-project-boards)."
diff --git a/content/github/managing-your-work-on-github/copying-a-project-board.md b/content/github/managing-your-work-on-github/copying-a-project-board.md
index 1d7225e79e..6b6f7afefc 100644
--- a/content/github/managing-your-work-on-github/copying-a-project-board.md
+++ b/content/github/managing-your-work-on-github/copying-a-project-board.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/copying-a-project-board
versions:
free-pro-team: '*'
+topics:
+ - pull requests
---
Copying a project board allows you to reuse a project board's title, description, and automation configuration. You can copy project boards to eliminate the manual process of creating new project boards for similar workflows.
diff --git a/content/github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet.md b/content/github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet.md
index 283530bf8d..f8f251b394 100644
--- a/content/github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet.md
+++ b/content/github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
This type of permanent link will render as a code snippet only in the repository it originated in. In other repositories, the permalink code snippet will render as a URL.
diff --git a/content/github/managing-your-work-on-github/creating-a-project-board.md b/content/github/managing-your-work-on-github/creating-a-project-board.md
index 77f0193882..4d4021f5a2 100644
--- a/content/github/managing-your-work-on-github/creating-a-project-board.md
+++ b/content/github/managing-your-work-on-github/creating-a-project-board.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.project-management.use-automated-template %}
diff --git a/content/github/managing-your-work-on-github/creating-an-issue.md b/content/github/managing-your-work-on-github/creating-an-issue.md
index bd2ff8d5a3..b0d3ea02a8 100644
--- a/content/github/managing-your-work-on-github/creating-an-issue.md
+++ b/content/github/managing-your-work-on-github/creating-an-issue.md
@@ -1,13 +1,15 @@
---
title: Creating an issue
intro: 'Issues can be used to keep track of bugs, enhancements, or other requests.'
-permissions: 'People with read permissions can create an issue in a repository where issues are enabled.'
+permissions: People with read permissions can create an issue in a repository where issues are enabled.
redirect_from:
- /articles/creating-an-issue
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can open a new issue based on code from an existing pull request. For more information, see "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)."
diff --git a/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md
index 0524cf9237..d8e3ae3338 100644
--- a/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/managing-your-work-on-github/deleting-a-project-board.md b/content/github/managing-your-work-on-github/deleting-a-project-board.md
index 365d7a03bc..edff31371e 100644
--- a/content/github/managing-your-work-on-github/deleting-a-project-board.md
+++ b/content/github/managing-your-work-on-github/deleting-a-project-board.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% tip %}
diff --git a/content/github/managing-your-work-on-github/deleting-an-issue.md b/content/github/managing-your-work-on-github/deleting-an-issue.md
index 705f41ff5a..0a087f1297 100644
--- a/content/github/managing-your-work-on-github/deleting-an-issue.md
+++ b/content/github/managing-your-work-on-github/deleting-an-issue.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can only delete issues in a repository owned by your user account. You cannot delete issues in a repository owned by another user account, even if you are a collaborator there.
diff --git a/content/github/managing-your-work-on-github/disabling-issues.md b/content/github/managing-your-work-on-github/disabling-issues.md
index 469bd2bac8..eb8ea5c679 100644
--- a/content/github/managing-your-work-on-github/disabling-issues.md
+++ b/content/github/managing-your-work-on-github/disabling-issues.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-settings %}
diff --git a/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md b/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md
index 5a3d679fd6..c6d6970768 100644
--- a/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md
+++ b/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you disable project boards, you will no longer see project board information in timelines or [audit logs](/articles/reviewing-your-security-log/).
diff --git a/content/github/managing-your-work-on-github/disabling-project-boards-in-your-organization.md b/content/github/managing-your-work-on-github/disabling-project-boards-in-your-organization.md
index 6b5579d3b6..e944f2866f 100644
--- a/content/github/managing-your-work-on-github/disabling-project-boards-in-your-organization.md
+++ b/content/github/managing-your-work-on-github/disabling-project-boards-in-your-organization.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
After you disable organization-wide project boards, it won’t be possible to create new project boards at the organization level, and any existing organization-level project boards will become inaccessible at their previous URLs. Project boards in repositories in the organization are not affected.
diff --git a/content/github/managing-your-work-on-github/editing-a-project-board.md b/content/github/managing-your-work-on-github/editing-a-project-board.md
index 0f9e5c977c..e9cc53d326 100644
--- a/content/github/managing-your-work-on-github/editing-a-project-board.md
+++ b/content/github/managing-your-work-on-github/editing-a-project-board.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% tip %}
diff --git a/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
index 4abe40a38f..abb1ae4b48 100644
--- a/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% warning %}
diff --git a/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md
index a4a1ee3f6f..4b1a22b3be 100644
--- a/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md
+++ b/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again.
diff --git a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-assignees.md b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-assignees.md
index e04db9f312..e39fd884ff 100644
--- a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-assignees.md
+++ b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-assignees.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.cli.filter-issues-and-pull-requests-tip %}
diff --git a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-labels.md b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-labels.md
index d0ad982702..33f6798afe 100644
--- a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-labels.md
+++ b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-labels.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.cli.filter-issues-and-pull-requests-tip %}
diff --git a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md
index d6c96b95d7..4f6d7d3eca 100644
--- a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md
+++ b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% tip %}
diff --git a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md
index 8459b5dd4d..a59627be7d 100644
--- a/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.search.requested_reviews_search %}
diff --git a/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md b/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md
index 58bd074a17..1d633e08f3 100644
--- a/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md
+++ b/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can filter a repository's list of pull requests to find:
diff --git a/content/github/managing-your-work-on-github/finding-information-in-a-repository.md b/content/github/managing-your-work-on-github/finding-information-in-a-repository.md
index ccc776aa0e..d90d3de261 100644
--- a/content/github/managing-your-work-on-github/finding-information-in-a-repository.md
+++ b/content/github/managing-your-work-on-github/finding-information-in-a-repository.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/index.md b/content/github/managing-your-work-on-github/index.md
index eb501619b0..a425a1a411 100644
--- a/content/github/managing-your-work-on-github/index.md
+++ b/content/github/managing-your-work-on-github/index.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md
index e99658d64f..b41b7ab75f 100644
--- a/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md
+++ b/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md
@@ -1,6 +1,6 @@
---
title: Linking a pull request to an issue
-intro: 'You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when the pull request is merged.'
+intro: You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when the pull request is merged.
redirect_from:
- /articles/closing-issues-via-commit-message/
- /articles/closing-issues-via-commit-messages/
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% note %}
diff --git a/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md b/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md
index e394df5c31..ee6c964732 100644
--- a/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md
+++ b/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/managing-labels.md b/content/github/managing-your-work-on-github/managing-labels.md
index 09e093c6b8..99a825c458 100644
--- a/content/github/managing-your-work-on-github/managing-labels.md
+++ b/content/github/managing-your-work-on-github/managing-labels.md
@@ -21,6 +21,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
### About labels
diff --git a/content/github/managing-your-work-on-github/managing-project-boards.md b/content/github/managing-your-work-on-github/managing-project-boards.md
index 4ecbcf476f..ccc1c55316 100644
--- a/content/github/managing-your-work-on-github/managing-project-boards.md
+++ b/content/github/managing-your-work-on-github/managing-project-boards.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md
index 7627c87e95..b8e7517513 100644
--- a/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md b/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md
index 64b72de5fd..644415774a 100644
--- a/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md
+++ b/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md
@@ -1,11 +1,13 @@
---
title: Opening an issue from a comment
intro: You can open a new issue from a specific comment in an issue or pull request.
-permissions: 'People with read permissions can create an issue in a repository where issues are enabled.'
+permissions: People with read permissions can create an issue in a repository where issues are enabled.
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you open an issue from a comment, the issue contains a snippet showing where the comment was originally posted.
diff --git a/content/github/managing-your-work-on-github/opening-an-issue-from-code.md b/content/github/managing-your-work-on-github/opening-an-issue-from-code.md
index 583221530d..9b07c631a2 100644
--- a/content/github/managing-your-work-on-github/opening-an-issue-from-code.md
+++ b/content/github/managing-your-work-on-github/opening-an-issue-from-code.md
@@ -1,13 +1,15 @@
---
title: Opening an issue from code
intro: You can open a new issue from a specific line or lines of code in a file or pull request.
-permissions: 'People with read permissions can create an issue in a repository where issues are enabled.'
+permissions: People with read permissions can create an issue in a repository where issues are enabled.
redirect_from:
- /articles/opening-an-issue-from-code
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you open an issue from code, the issue contains a snippet showing the line or range of code you chose. You can only open an issue in the same repository where the code is stored.
diff --git a/content/github/managing-your-work-on-github/pinning-an-issue-to-your-repository.md b/content/github/managing-your-work-on-github/pinning-an-issue-to-your-repository.md
index 6786f5add2..4b8baf8b85 100644
--- a/content/github/managing-your-work-on-github/pinning-an-issue-to-your-repository.md
+++ b/content/github/managing-your-work-on-github/pinning-an-issue-to-your-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/reopening-a-closed-project-board.md b/content/github/managing-your-work-on-github/reopening-a-closed-project-board.md
index 4ddda31852..17939004ef 100644
--- a/content/github/managing-your-work-on-github/reopening-a-closed-project-board.md
+++ b/content/github/managing-your-work-on-github/reopening-a-closed-project-board.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
When you close a project board, any workflow automation that was configured for the project board will pause by default. For more information, see "[Closing a project board](/articles/closing-a-project-board)."
diff --git a/content/github/managing-your-work-on-github/sharing-filters.md b/content/github/managing-your-work-on-github/sharing-filters.md
index deaa2e4d84..8575fb7e80 100644
--- a/content/github/managing-your-work-on-github/sharing-filters.md
+++ b/content/github/managing-your-work-on-github/sharing-filters.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can send the URL that issues generates to any user, and they'll be able to see the same filter view that you see.
diff --git a/content/github/managing-your-work-on-github/sorting-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/sorting-issues-and-pull-requests.md
index 0137ba5be2..9decbf89e3 100644
--- a/content/github/managing-your-work-on-github/sorting-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/sorting-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
You can sort any filtered view by:
diff --git a/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md b/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md
index dd4915bbee..6eb703d108 100644
--- a/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md
+++ b/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.project-management.project-progress-locations %}
diff --git a/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md b/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md
index 289f06851c..081bd66cfd 100644
--- a/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md
+++ b/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md b/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md
index 6bdc399895..9ad7f25801 100644
--- a/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md
+++ b/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md
@@ -9,5 +9,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
diff --git a/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md
index 64920e0815..d7c5ba7a59 100644
--- a/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md
+++ b/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
To transfer an open issue to another repository, you must have write permissions on the repository the issue is in and the repository you're transferring the issue to. For more information, see "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)."
diff --git a/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md
index 102296457c..68aac842f1 100644
--- a/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
The issues and pull requests search bar allows you to define your own custom filters and sort by a wide variety of criteria. You can find the search bar on each repository's **Issues** and **Pull requests** tabs and on your [Issues and Pull requests dashboards](/articles/viewing-all-of-your-issues-and-pull-requests).
diff --git a/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md b/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md
index 289597f46b..0a5c9f90dd 100644
--- a/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md
+++ b/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
Your issues and pull request dashboards are available at the top of any page. On each dashboard, you can filter the list to find issues or pull requests you created, that are assigned to you, or in which you're mentioned. You can also find pull requests that you've been asked to review.
diff --git a/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md b/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md
index 0fc56efbff..a67a141429 100644
--- a/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md
+++ b/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pull requests
---
{% data reusables.repositories.navigate-to-repo %}
diff --git a/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md
index 6205d243d6..39e0433971 100644
--- a/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md
+++ b/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md
@@ -5,7 +5,7 @@ versions:
enterprise-server: <2.21
---
-By default, you'll automatically receive notifications for team discussions you're a member of. If you don't want to receive certain notifications for an existing team discussion, you must unwatch that team. You can also unsubscribe or subscribe to specific team discussion posts. For more information, see "[About team discussions](/articles/about-team-discussions)" and "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)."
+By default, you'll automatically receive notifications for team discussions you're a member of. If you don't want to receive certain notifications for an existing team discussion, you must unwatch that team. You can also unsubscribe or subscribe to specific team discussion posts. For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)" and "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)."
If you don't want to automatically watch team discussions when you become a member of new teams, you can update your automatic watching settings.
@@ -58,5 +58,5 @@ If you don't want to automatically receive team discussion notifications when yo
### Further reading
- "[About notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)"
-- "[About team discussions](/articles/about-team-discussions)"
+- "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)"
- "[About teams](/articles/about-teams)"
diff --git a/content/github/searching-for-information-on-github/about-searching-on-github.md b/content/github/searching-for-information-on-github/about-searching-on-github.md
index 39c71d8a5b..44c994ea1b 100644
--- a/content/github/searching-for-information-on-github/about-searching-on-github.md
+++ b/content/github/searching-for-information-on-github/about-searching-on-github.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
{% data reusables.search.you-can-search-globally %}
diff --git a/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md b/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md
index 20e4232077..df48291d6e 100644
--- a/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md
+++ b/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - github search
---
If you use {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_dotcom_the_website %} and your {% data variables.product.prodname_ghe_server %} site administrator has enabled {% data variables.product.prodname_github_connect %} and {% data variables.product.prodname_unified_search %} for private repositories, then you can search for designated private repositories in the connected organization.
diff --git a/content/github/searching-for-information-on-github/finding-files-on-github.md b/content/github/searching-for-information-on-github/finding-files-on-github.md
index b5f1b9d22b..6206ebfb82 100644
--- a/content/github/searching-for-information-on-github/finding-files-on-github.md
+++ b/content/github/searching-for-information-on-github/finding-files-on-github.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
{% tip %}
diff --git a/content/github/searching-for-information-on-github/getting-started-with-searching-on-github.md b/content/github/searching-for-information-on-github/getting-started-with-searching-on-github.md
index 75b823525a..b29b41a6b2 100644
--- a/content/github/searching-for-information-on-github/getting-started-with-searching-on-github.md
+++ b/content/github/searching-for-information-on-github/getting-started-with-searching-on-github.md
@@ -7,5 +7,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
diff --git a/content/github/searching-for-information-on-github/index.md b/content/github/searching-for-information-on-github/index.md
index e95408d576..d5c9601add 100644
--- a/content/github/searching-for-information-on-github/index.md
+++ b/content/github/searching-for-information-on-github/index.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
diff --git a/content/github/searching-for-information-on-github/searching-code.md b/content/github/searching-for-information-on-github/searching-code.md
index f03e26fb17..41c64e585a 100644
--- a/content/github/searching-for-information-on-github/searching-code.md
+++ b/content/github/searching-for-information-on-github/searching-code.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
{% data reusables.search.you-can-search-globally %} For more information, see "[About searching on GitHub](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/searching-commits.md b/content/github/searching-for-information-on-github/searching-commits.md
index a2fe749c4b..fc7c3da237 100644
--- a/content/github/searching-for-information-on-github/searching-commits.md
+++ b/content/github/searching-for-information-on-github/searching-commits.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
You can search for commits globally across all of {% data variables.product.product_name %}, or search for commits within a particular repository or organization. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/searching-discussions.md b/content/github/searching-for-information-on-github/searching-discussions.md
index 5e4097328f..7485132659 100644
--- a/content/github/searching-for-information-on-github/searching-discussions.md
+++ b/content/github/searching-for-information-on-github/searching-discussions.md
@@ -1,8 +1,10 @@
---
title: Searching discussions
-intro: You can search for discussions on {% data variables.product.product_name %} and narrow the results using search qualifiers.
+intro: 'You can search for discussions on {% data variables.product.product_name %} and narrow the results using search qualifiers.'
versions:
free-pro-team: '*'
+topics:
+ - github search
---
{% data reusables.discussions.beta %}
diff --git a/content/github/searching-for-information-on-github/searching-for-packages.md b/content/github/searching-for-information-on-github/searching-for-packages.md
index 908a5b758f..5ec6be82f4 100644
--- a/content/github/searching-for-information-on-github/searching-for-packages.md
+++ b/content/github/searching-for-information-on-github/searching-for-packages.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - github search
---
{% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/github/searching-for-information-on-github/searching-for-repositories.md b/content/github/searching-for-information-on-github/searching-for-repositories.md
index f66b04b94e..081ea49f58 100644
--- a/content/github/searching-for-information-on-github/searching-for-repositories.md
+++ b/content/github/searching-for-information-on-github/searching-for-repositories.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
You can search for repositories globally across all of {% data variables.product.product_location %}, or search for repositories within a particular organization. For more information, see "[About searching on {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/searching-github-marketplace.md b/content/github/searching-for-information-on-github/searching-github-marketplace.md
index 8521b5faaa..95b23ef0c2 100644
--- a/content/github/searching-for-information-on-github/searching-github-marketplace.md
+++ b/content/github/searching-for-information-on-github/searching-github-marketplace.md
@@ -3,6 +3,8 @@ title: Searching GitHub Marketplace
intro: 'You can search for apps and actions that are available on {% data variables.product.prodname_marketplace %}.'
versions:
free-pro-team: '*'
+topics:
+ - github search
---
### About searching {% data variables.product.prodname_marketplace %}
diff --git a/content/github/searching-for-information-on-github/searching-in-forks.md b/content/github/searching-for-information-on-github/searching-in-forks.md
index 00f94f10b1..4adaa01863 100644
--- a/content/github/searching-for-information-on-github/searching-in-forks.md
+++ b/content/github/searching-for-information-on-github/searching-in-forks.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
To show forks in [repository search](/articles/searching-for-repositories) results, add `fork:true` or `fork:only` to your query.
diff --git a/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md b/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md
index 1ee2d6f95e..8175068037 100644
--- a/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md
+++ b/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
You can search for issues and pull requests globally across all of {% data variables.product.product_name %}, or search for issues and pull requests within a particular organization. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/searching-on-github.md b/content/github/searching-for-information-on-github/searching-on-github.md
index 26639b46a1..add2f14613 100644
--- a/content/github/searching-for-information-on-github/searching-on-github.md
+++ b/content/github/searching-for-information-on-github/searching-on-github.md
@@ -7,5 +7,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
diff --git a/content/github/searching-for-information-on-github/searching-topics.md b/content/github/searching-for-information-on-github/searching-topics.md
index 99cab36c66..d56c5390ff 100644
--- a/content/github/searching-for-information-on-github/searching-topics.md
+++ b/content/github/searching-for-information-on-github/searching-topics.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
### Search {% data variables.product.product_name %} for topics
diff --git a/content/github/searching-for-information-on-github/searching-users.md b/content/github/searching-for-information-on-github/searching-users.md
index 325fe570e9..6cd812eb6f 100644
--- a/content/github/searching-for-information-on-github/searching-users.md
+++ b/content/github/searching-for-information-on-github/searching-users.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
You can search for users globally across all of {% data variables.product.product_name %}. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/searching-wikis.md b/content/github/searching-for-information-on-github/searching-wikis.md
index 20e4ea13be..121f4d8949 100644
--- a/content/github/searching-for-information-on-github/searching-wikis.md
+++ b/content/github/searching-for-information-on-github/searching-wikis.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
You can search wikis globally across all of {% data variables.product.product_name %}, or search wikis within a particular repository or organization. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)."
diff --git a/content/github/searching-for-information-on-github/sorting-search-results.md b/content/github/searching-for-information-on-github/sorting-search-results.md
index 63a87f4ea8..cca11dff24 100644
--- a/content/github/searching-for-information-on-github/sorting-search-results.md
+++ b/content/github/searching-for-information-on-github/sorting-search-results.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
Use the Sort menu to sort results by relevance, number of stars, number of forks, and how recently the items were updated.
diff --git a/content/github/searching-for-information-on-github/troubleshooting-search-queries.md b/content/github/searching-for-information-on-github/troubleshooting-search-queries.md
index 1ef5321599..c43385c2be 100644
--- a/content/github/searching-for-information-on-github/troubleshooting-search-queries.md
+++ b/content/github/searching-for-information-on-github/troubleshooting-search-queries.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
### Potential timeouts
diff --git a/content/github/searching-for-information-on-github/understanding-the-search-syntax.md b/content/github/searching-for-information-on-github/understanding-the-search-syntax.md
index 9f09082205..dc1b05d6fe 100644
--- a/content/github/searching-for-information-on-github/understanding-the-search-syntax.md
+++ b/content/github/searching-for-information-on-github/understanding-the-search-syntax.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - github search
---
### Query for values greater or less than another value
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md
index 7abf04ebd9..84f966fe47 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-billing-for-git-large-file-storage
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### About billing for {% data variables.large_files.product_name_long %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md
index ee973ad804..eb9ad6bc36 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md
@@ -12,6 +12,8 @@ redirect_from:
- /articles/about-billing-for-github-accounts
versions:
free-pro-team: '*'
+topics:
+ - billing
---
For more information on the products available for your account, see "[{% data variables.product.product_name %}'s products](/articles/github-s-products)." You can see pricing and a full list of features for each product at <{% data variables.product.pricing_url %}>. {% data variables.product.product_name %} does not offer custom products or subscriptions.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md
index 99af79b584..2a0027703f 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md
@@ -4,6 +4,8 @@ intro: 'If you want to use {% data variables.product.prodname_actions %} beyond
product: '{% data reusables.gated-features.actions %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### About billing for {% data variables.product.prodname_actions %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md
index ae029cc60b..9c5932d9e1 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-billing-for-github-marketplace
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data variables.product.prodname_marketplace %} includes apps with free and paid pricing plans. After you purchase and install an app, you can upgrade, downgrade, or cancel at any time.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md
index 1d3fa8d063..590bd13680 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md
@@ -4,6 +4,8 @@ intro: 'If you want to use {% data variables.product.prodname_registry %} beyond
product: '{% data reusables.gated-features.packages %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### About billing for {% data variables.product.prodname_registry %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-sponsors.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-sponsors.md
index f5cb393123..19604added 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-sponsors.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-sponsors.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-billing-for-github-sponsors
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.sponsors.sponsorship-details %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md
index 8b377b21e1..42a40a8e55 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-billing-on-github
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Paid features and products
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security.md
index e60a2c91ff..732af53a92 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security.md
@@ -1,6 +1,7 @@
---
title: About licensing for GitHub Advanced Security
intro: 'If you want to use {% data variables.product.prodname_GH_advanced_security %} features in a private or internal repository, you need a license. These features are available free of charge for public repositories.'
+product: '{% data reusables.gated-features.ghas %}'
versions:
free-pro-team: '*'
---
@@ -11,22 +12,20 @@ If you want to use {% data variables.product.prodname_GH_advanced_security %} fe
{% data reusables.advanced-security.license-overview %}
-You can buy a license for an organization that is owned by a user account or for your enterprise account. If you want to use {% data variables.product.prodname_GH_advanced_security %} features for a private, user-owned repository, you must transfer the repository to an organization with a license.
-
-To discuss licensing for {% data variables.product.prodname_GH_advanced_security %}, contact {% data variables.contact.contact_enterprise_sales %}.
+To discuss licensing {% data variables.product.prodname_GH_advanced_security %} for your enterprise account, contact {% data variables.contact.contact_enterprise_sales %}.
### About committer numbers for {% data variables.product.prodname_GH_advanced_security %}
We record and display two numbers of committers for {% data variables.product.prodname_GH_advanced_security %} on {% data variables.product.prodname_dotcom_the_website %}:
-- **Committers** is the number of committers who contributed to at least one private repository in an organization and who use a seat in your license. That is, they are also an organization member, an external collaborator, or have a pending invitation to join your organization or enterprise account.
+- **Committers** is the number of committers who contributed to at least one private repository in an organization and who use a seat in your license. That is, they are also an organization member, an external collaborator, or have a pending invitation to join an organization in your enterprise.
- **Unique to this repository/organization** is the number of committers who contributed only to this repository, or to repositories in this organization. This number shows how many license seats you can free up by disabling {% data variables.product.prodname_GH_advanced_security %} for that repository or organization.
If there are no unique committers, this means that all active committers also contribute to other repositories or organizations that use {% data variables.product.prodname_GH_advanced_security %}. Disabling the feature for that repository or organization would not free any seats on your license.
{% note %}
-**Note:** The total number of seats used in your license is not the sum of either the committers or the unique committers to each repository or organization. This is because there are people who contribute to multiple repositories or organizations. The number of seats used is measured across the whole enterprise or organization account to ensure that each person is counted only once regardless of how many repositories or organizations they contribute to.
+**Note:** The total number of seats used in your license is not the sum of either the committers or the unique committers to each repository or organization. This is because there are people who contribute to multiple repositories or organizations. The number of seats used is measured across the whole enterprise account to ensure that each person is counted only once regardless of how many repositories or organizations they contribute to.
{% endnote %}
@@ -47,4 +46,4 @@ When you decide which repositories and organizations to prioritize for {% data v
- Codebases that are the most critical to your company's success. These are the projects for which the introduction of vulnerable code, hard-coded secrets, or vulnerable dependencies would have the greatest impact on your company.
- Codebases with the highest commit frequency. These are the most actively developed projects, consequently there is a higher risk that security problems could be introduced.
-When you have enabled {% data variables.product.prodname_GH_advanced_security %} for these organizations or repositories, you should assess which other codebases you could add without adding any extra unique committers and using up more seats on your license. After this, review the next most important and busy code bases. If you want to increase the number of seats in your license, contact {% data variables.contact.contact_enterprise_sales %}.
+When you have enabled {% data variables.product.prodname_GH_advanced_security %} for these organizations or repositories, you should assess which other codebases you could add without adding any extra unique committers and using up more seats on your license. After this, review the next most important and busy codebases. If you want to increase the number of seats in your license, contact {% data variables.contact.contact_enterprise_sales %}.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md
index 620bb92d7c..7528a07c86 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/about-organizations-for-procurement-companies
versions:
free-pro-team: '*'
+topics:
+ - billing
---
To access an organization, each member must sign into their own personal user account.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md
index 4ad2ca3d40..88e02ca788 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-per-user-pricing
versions:
free-pro-team: '*'
+topics:
+ - billing
---
New organizations can build public and open-source projects with {% data variables.product.prodname_free_team %}, or [upgrade]({% data variables.product.pricing_url %}) to a paid product with per-user pricing.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md
index 978c384796..3f9b261206 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md
@@ -13,6 +13,8 @@ redirect_from:
- /articles/adding-information-to-your-receipts
versions:
free-pro-team: '*'
+topics:
+ - billing
---
Your receipts include your {% data variables.product.prodname_dotcom %} subscription as well as any subscriptions for [other paid features and products](/articles/about-billing-on-github).
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-or-editing-a-payment-method.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-or-editing-a-payment-method.md
index 2252335a71..dbdcb5afdd 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-or-editing-a-payment-method.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-or-editing-a-payment-method.md
@@ -17,6 +17,8 @@ redirect_from:
- /articles/adding-or-editing-a-payment-method
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.dotcom_billing.payment-methods %} {% data reusables.dotcom_billing.same-payment-method %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md
index 8ea7be345d..56f1b47629 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/canceling-a-github-marketplace-app
versions:
free-pro-team: '*'
+topics:
+ - billing
---
When you cancel an app, your subscription remains active until the end of your current billing cycle. The cancellation takes effect on your next billing date. For more information, see "[About billing for {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)."
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md
index be7799346d..69126ef59b 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md
@@ -8,6 +8,8 @@ redirect_from:
- /articles/changing-the-duration-of-your-billing-cycle
versions:
free-pro-team: '*'
+topics:
+ - billing
---
When you change your billing cycle's duration, your {% data variables.product.prodname_dotcom %} subscription, along with any other paid features and products, will be moved to your new billing cycle on your next billing date.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md
index c1743cd9df..c68cc1fd99 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/creating-and-paying-for-an-organization-on-behalf-of-a-client
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Requirements
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md
index 4f1306773f..171d6f1003 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md
@@ -8,6 +8,8 @@ redirect_from:
- /articles/discounted-subscriptions-for-github-accounts
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md
index 4d9595814c..55d99d1503 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/downgrading-a-sponsorship
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.sponsors.org-sponsors-release-phase %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md
index 8ae0090550..d297c4ee39 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/downgrading-git-large-file-storage
versions:
free-pro-team: '*'
+topics:
+ - billing
---
When you downgrade your number of data packs, your change takes effect on your next billing date. For more information, see "[About billing for {% data variables.large_files.product_name_long %}](/articles/about-billing-for-git-large-file-storage)."
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md
index 0ee8629d63..b9c50ec438 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/downgrading-the-billing-plan-for-a-github-marketplace-app
versions:
free-pro-team: '*'
+topics:
+ - billing
---
When you downgrade an app, your subscription remains active until the end of your current billing cycle. The downgrade takes effect on your next billing date. For more information, see "[About billing for {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)."
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md
index 52e4c319e3..cbc71c572f 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md
@@ -17,6 +17,8 @@ redirect_from:
- /articles/downgrading-your-github-subscription
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Downgrading your {% data variables.product.product_name %} subscription
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md
index 28dcc69c66..5ee620bf4b 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/how-does-upgrading-or-downgrading-affect-the-billing-process
versions:
free-pro-team: '*'
+topics:
+ - billing
---
Changes to your paid user account or organization subscription does not affect subscriptions or payments for other paid {% data variables.product.prodname_dotcom %} features, such as {% data variables.large_files.product_name_long %} or paid apps purchased in {% data variables.product.prodname_marketplace %}.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/index.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/index.md
index d96469992f..486292fcdd 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/index.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/index.md
@@ -5,6 +5,8 @@ redirect_from:
- /categories/setting-up-and-managing-billing-and-payments-on-github
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md
index 8e2bf2e7cc..bca4ee4352 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md
@@ -9,5 +9,7 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions.md
index 39f3088888..b8c8c8f629 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions.md
@@ -4,5 +4,7 @@ intro: 'You can view your usage and set a spending limit for {% data variables.p
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md
index 3f00310c38..8eec46d9b3 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md
@@ -8,5 +8,7 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-packages.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-packages.md
index 18f10a288a..4842c9eb73 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-packages.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-packages.md
@@ -4,5 +4,7 @@ intro: 'You can view your {% data variables.product.prodname_registry %} usage a
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-sponsors.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-sponsors.md
index f03d1f05d6..9b58bc5296 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-sponsors.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-sponsors.md
@@ -6,5 +6,7 @@ redirect_from:
- /articles/managing-billing-for-github-sponsors
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-your-github-account.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-your-github-account.md
index 929708d3ea..c9ca0b8cc9 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-your-github-account.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-your-github-account.md
@@ -14,5 +14,7 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-licensing-for-github-advanced-security.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-licensing-for-github-advanced-security.md
index 6af70a3655..c10dea733a 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-licensing-for-github-advanced-security.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-licensing-for-github-advanced-security.md
@@ -2,6 +2,7 @@
title: Managing licensing for GitHub Advanced Security
intro: 'You can view and manage your use of seats on a license for {% data variables.product.prodname_advanced_security %}.'
mapTopic: true
+product: '{% data reusables.gated-features.ghas %}'
versions:
free-pro-team: '*'
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md
index e684dad17c..1f95070192 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md
@@ -12,5 +12,7 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md
index 0640df74bb..5c60d891b5 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md
@@ -4,6 +4,8 @@ intro: 'You can set a spending limit for {% data variables.product.prodname_acti
product: '{% data reusables.gated-features.actions %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### About spending limits for {% data variables.product.prodname_actions %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md
index 250aaab93a..e5fa4995f3 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md
@@ -4,6 +4,8 @@ intro: 'You can set a spending limit for {% data variables.product.prodname_regi
product: '{% data reusables.gated-features.packages %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### About spending limits for {% data variables.product.prodname_registry %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md
index 7ba2f81725..038f5af655 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md
@@ -8,6 +8,8 @@ redirect_from:
- /articles/redeeming-a-coupon
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data variables.product.product_name %} can't issue a refund if you pay for an account before applying a coupon. We also can't transfer a redeemed coupon or give you a new coupon if you apply it to the wrong account. Confirm that you're applying the coupon to the correct account before you redeem a coupon.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md
index d28d8cb4be..4487393f5a 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md
@@ -9,6 +9,8 @@ redirect_from:
- /articles/removing-a-payment-method
versions:
free-pro-team: '*'
+topics:
+ - billing
---
If you're paying for your {% data variables.product.product_name %} subscription with a coupon, and you aren't using your payment method for any [other paid features or products](/articles/about-billing-on-github) on {% data variables.product.product_name %}, you can remove your credit card or PayPal information.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md
index 95f32e829c..77eb7a3166 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/renewing-your-clients-paid-organization
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.organizations.reseller-ask-to-become-billing-manager %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md
index f2ed48d2f9..66a29895ee 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md
@@ -8,5 +8,7 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - billing
---
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md
index a2d2fb3b7d..ffe4d5ed49 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md
@@ -9,6 +9,8 @@ redirect_from:
- /articles/setting-your-billing-email
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Setting your personal account's billing email
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md
index f76f433b3a..e0951dd49f 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/troubleshooting-a-declined-credit-card-charge
versions:
free-pro-team: '*'
+topics:
+ - billing
---
If your card is declined, we'll send you an email about why the payment was declined. You'll have a few days to resolve the problem before we try charging you again.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md
index bc7968d21e..06d264a1ba 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md
@@ -11,6 +11,8 @@ redirect_from:
- /articles/unlocking-a-locked-account
versions:
free-pro-team: '*'
+topics:
+ - billing
---
You can unlock and access your account by updating your organization's payment method and resuming paid status. We do not ask you to pay for the time elapsed in locked mode.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md
index cd65d50f26..71d7d250f8 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/upgrading-a-sponsorship
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.sponsors.org-sponsors-release-phase %}
@@ -18,4 +20,4 @@ When you upgrade your sponsorship tier, the change will become effective immedia
{% data reusables.sponsors.navigate-to-sponsored-account %}
{% data reusables.sponsors.sponsorship-dashboard %}
{% data reusables.sponsors.select-a-tier %}
-{% data reusables.sponsors.update-sponsorship %}
\ No newline at end of file
+{% data reusables.sponsors.update-sponsorship %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md
index 19dd20d6d3..cfaee9f15b 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/upgrading-git-large-file-storage
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Purchasing additional storage and bandwidth for a personal account
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md
index a92f60b039..6ff83d7659 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/upgrading-or-downgrading-your-clients-paid-organization
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.organizations.reseller-ask-to-become-billing-manager %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md
index 47f0471d8d..b6647fe927 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/upgrading-the-billing-plan-for-a-github-marketplace-app
versions:
free-pro-team: '*'
+topics:
+ - billing
---
When you upgrade an app, your payment method is charged a prorated amount based on the time remaining until your next billing date. For more information, see "[About billing for {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)."
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md
index 782a9b2f4a..848bdc0cf1 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md
@@ -19,6 +19,8 @@ redirect_from:
- /articles/upgrading-your-github-subscription
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Upgrading your personal account's subscription
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md
index 260b634f81..deef9231ef 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md
@@ -8,6 +8,8 @@ redirect_from:
- /articles/viewing-and-managing-pending-changes-to-your-subscription
versions:
free-pro-team: '*'
+topics:
+ - billing
---
You can cancel pending changes to your account's subscription as well as pending changes to your subscriptions to other paid features and products.
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md
index 10f786b60d..71811a02e0 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/viewing-your-git-large-file-storage-usage
versions:
free-pro-team: '*'
+topics:
+ - billing
---
{% data reusables.large_files.owner_quota_only %} {% data reusables.large_files.does_not_carry %}
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md
index 1c16ae50ef..a9614ba2a4 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md
@@ -4,6 +4,8 @@ intro: 'You can view details of your usage of minutes and storage for {% data va
product: '{% data reusables.gated-features.actions %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
You can also view the billable job execution minutes for an individual workflow run. For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)."
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-advanced-security-usage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-advanced-security-usage.md
index 6b3107ffe5..3e9d1d052a 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-advanced-security-usage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-advanced-security-usage.md
@@ -2,6 +2,7 @@
title: Viewing your GitHub Advanced Security usage
intro: 'You can view and manage usage of your {% data variables.product.prodname_GH_advanced_security %} license.'
permissions: Organization and enterprise owners can manage access to {% data variables.product.prodname_GH_advanced_security %} for their organization or enterprise organizations.
+product: '{% data reusables.gated-features.ghas %}'
redirect_from: /github/setting-up-and-managing-your-enterprise/managing-use-of-advanced-security-for-organizations-in-your-enterprise-account
versions:
free-pro-team: '*'
@@ -9,20 +10,6 @@ versions:
Each license for {% data variables.product.prodname_GH_advanced_security %} specifies a maximum number of accounts, or seats, that can use these features. Periodically you should check that your use is within your license capacity. For more information, see "[About licensing for {% data variables.product.prodname_GH_advanced_security %} enterprise license](/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security)."
-### Viewing and managing {% data variables.product.prodname_GH_advanced_security %} license usage for your organization
-
-You can check how many seats your license includes and how many of them are currently used on the "Billing & plans" page for your organization.
-
-{% data reusables.profile.access_profile %}
-{% data reusables.profile.access_org %}
-{% data reusables.organizations.org_settings %}
-{% data reusables.organizations.billing_planning %}
-5. Optionally, in the "{% data variables.product.prodname_GH_advanced_security %}" section, click **Manage repositories** to see the usage for each repository that has the feature enabled.
- 
-6. Scroll to the "{% data variables.product.prodname_GH_advanced_security %} repositories" section to see a detailed breakdown of usage by repository for your organization.
- 
- For more information, see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)."
-
### Viewing and managing {% data variables.product.prodname_GH_advanced_security %} license usage for your enterprise account
You can check how many seats your license includes and how many of them are currently used on the "Enterprise licensing" page.
@@ -43,3 +30,4 @@ You can check how many seats your license includes and how many of them are curr
6. On the "Security & analysis" settings page, scroll to the "{% data variables.product.prodname_GH_advanced_security %} repositories" section to see a detailed breakdown of usage by repository for this organization.
For more information, see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)."
+
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md
index fcf65f1ada..11fbf086b3 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md
@@ -4,6 +4,8 @@ intro: 'You can view details of your usage of storage and data transfer for {% d
product: '{% data reusables.gated-features.packages %}'
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Viewing {% data variables.product.prodname_registry %} usage for your user account
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-payment-history-and-receipts.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-payment-history-and-receipts.md
index 7f939cf84c..5b7e84b959 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-payment-history-and-receipts.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-payment-history-and-receipts.md
@@ -8,6 +8,8 @@ redirect_from:
- /articles/viewing-your-payment-history-and-receipts
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Viewing receipts for your personal account
diff --git a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md
index 71591f0aef..a04c021853 100644
--- a/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md
+++ b/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md
@@ -9,6 +9,8 @@ redirect_from:
- /articles/viewing-your-subscriptions-and-billing-date
versions:
free-pro-team: '*'
+topics:
+ - billing
---
### Finding your personal account's next billing date
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-identity-and-access-management-with-saml-single-sign-on.md b/content/github/setting-up-and-managing-organizations-and-teams/about-identity-and-access-management-with-saml-single-sign-on.md
index 624a03a885..154855ba68 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-identity-and-access-management-with-saml-single-sign-on.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-identity-and-access-management-with-saml-single-sign-on.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/about-identity-and-access-management-with-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About SAML SSO
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md b/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md
index 5da63c8dc8..4122072bda 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/about-oauth-app-access-restrictions
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
When {% data variables.product.prodname_oauth_app %} access restrictions are enabled, organization members cannot authorize {% data variables.product.prodname_oauth_app %} access to organization resources. Organization members can request owner approval for {% data variables.product.prodname_oauth_app %}s they'd like to use, and organization owners receive a notification of pending requests.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md
index 308abb2d5f..9b777b5eee 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.organizations_include %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md b/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md
index 0fbcbda6ba..36f06c2387 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/about-scim
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
If you use [SAML SSO](/articles/about-identity-and-access-management-with-saml-single-sign-on) in your organization, you can implement SCIM to add, manage, and remove organization members' access to {% data variables.product.product_name %}. For example, an administrator can deprovision an organization member using SCIM and automatically remove the member from the organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md
index 1b57c0922c..a61f9370d5 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
An SSH certificate is a mechanism for one SSH key to sign another SSH key. If you use an SSH certificate authority (CA) to provide your organization members with signed SSH certificates, you can add the CA to your enterprise account or organization to allow organization members to use their certificates to access organization resources. For more information, see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)."
diff --git a/content/github/building-a-strong-community/about-team-discussions.md b/content/github/setting-up-and-managing-organizations-and-teams/about-team-discussions.md
similarity index 89%
rename from content/github/building-a-strong-community/about-team-discussions.md
rename to content/github/setting-up-and-managing-organizations-and-teams/about-team-discussions.md
index 6bf572b9e9..d95bfccf08 100644
--- a/content/github/building-a-strong-community/about-team-discussions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-team-discussions.md
@@ -3,10 +3,13 @@ title: About team discussions
intro: 'Your team can plan together, update one another, or talk about any topic you''d like in discussion posts on your team''s page in an organization.'
redirect_from:
- /articles/about-team-discussions
+ - /github/building-a-strong-community/about-team-discussions
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% data reusables.organizations.team-discussions-purpose %}
@@ -15,7 +18,7 @@ Any organization member can post on your team's page or participate in a public
-You can link to any team discussion to reference it elsewhere. You can pin important posts to your team's page for quick reference later. For more information, see "[Pinning a team discussion](/articles/pinning-a-team-discussion)."
+You can link to any team discussion to reference it elsewhere. You can pin important posts to your team's page for quick reference later. For more information, see "[Pinning a team discussion](/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion)."
@@ -41,5 +44,5 @@ For more information, see {% if currentVersion == "free-pro-team@latest" or curr
- "[About conversations on {% data variables.product.prodname_dotcom %}](/articles/about-conversations-on-github)"
- "[About teams](/articles/about-teams)"
-- "[Creating a team discussion](/articles/creating-a-team-discussion)"
-- "[Editing or deleting a team discussion](/articles/editing-or-deleting-a-team-discussion)"
+- "[Creating a team discussion](/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion)"
+- "[Editing or deleting a team discussion](/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion)"
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md b/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md
index 6d56d44867..aa9b95d1fd 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
@@ -36,7 +39,7 @@ You can also use LDAP Sync to synchronize {% data variables.product.product_loca
Each team has its own page within an organization. On a team's page, you can view team members, child teams, and the team's repositories. Organization owners and team maintainers can access team settings and update the team's description and profile picture from the team's page.
-Organization members can create and participate in discussions with the team. For more information, see "[About team discussions](/articles/about-team-discussions)."
+Organization members can create and participate in discussions with the team. For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md b/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md
index d75c5114c7..d061e78d3a 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/about-two-factor-authentication-and-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Two-factor authentication (2FA) provides basic authentication for organization members. By enabling 2FA, organization administrators limit the likelihood that a member's {% data variables.product.product_name %} account could be compromised. For more information on 2FA, see "[About two-factor authentication](/articles/about-two-factor-authentication)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md b/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md
index fe9be4889c..c2c416383a 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### Accessing your organization dashboard
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md b/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md
index 22f71d1f17..daa42f63eb 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
An organization's news feed shows other people's activity on repositories owned by that organization. You can use your organization's news feed to see when someone opens, closes, or merges an issue or pull request, creates or deletes a branch, creates a tag or release, comments on an issue, pull request, or commit, or pushes new commits to {% data variables.product.product_name %}.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md b/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md
index 684e4a4f31..6cea7ad0bd 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/accessing-your-organization-if-your-identity-provider-is-unavailable
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Organization administrators can use [one of their downloaded or saved recovery codes](/articles/downloading-your-organization-s-saml-single-sign-on-recovery-codes) to bypass single sign-on. You may have saved these to a password manager, such as [LastPass](https://lastpass.com/), [1Password](https://1password.com/), or [Keeper](https://keepersecurity.com/).
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md b/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md
index a3107304bd..cbddd686f4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md
@@ -13,6 +13,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/adding-a-billing-manager-to-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/adding-a-billing-manager-to-your-organization.md
index 7a1580b75f..f9ae9677a0 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/adding-a-billing-manager-to-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/adding-a-billing-manager-to-your-organization.md
@@ -5,6 +5,10 @@ redirect_from:
- /articles/adding-a-billing-manager-to-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
+ - billing
---
Members of your organization's Owners team can give *billing manager* permissions to people. Once a person accepts their invitation to become a billing manager for your organization, they can invite additional people to be billing managers.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md
index f7b11a7a0f..0332b57bcf 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
An outside collaborator is a person who isn't explicitly a member of your organization, but who has permissions to a project board in your organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md
index b548094db8..3af305e777 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
For more information about {% data variables.product.prodname_github_app %} manager permissions, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization#github-app-managers)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
index 95eaedc296..e1152db89d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.team-synchronization %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/adding-outside-collaborators-to-repositories-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/adding-outside-collaborators-to-repositories-in-your-organization.md
index e38a631a7f..66a47afe1f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/adding-outside-collaborators-to-repositories-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/adding-outside-collaborators-to-repositories-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.owners-and-admins-can %} add outside collaborators to a repository, unless an organization owner has restricted the ability to invite collaborators. For more information, see "[Setting permissions for adding outside collaborators](/articles/setting-permissions-for-adding-outside-collaborators)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md
index 3a68f66481..9c994b1884 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
By default, issues cannot be deleted in an organization's repositories. An organization owner must enable this feature for all of the organization's repositories first.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md
index 8396a30e64..f228264ab7 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/approving-oauth-apps-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
When {% data variables.product.prodname_oauth_app %} access restrictions are enabled, organization members must [request approval](/articles/requesting-organization-approval-for-oauth-apps) from an organization owner before they can authorize an {% data variables.product.prodname_oauth_app %} that has access to the organization's resources.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md
index 6e719b47ed..27a51a313a 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md
@@ -6,6 +6,9 @@ redirect_from:
intro: 'While you can add users to an organization you''ve created, you can''t create personal user accounts on behalf of another person.'
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Because you access an organization by logging in to a personal account, each of your team members needs a personal account. Once you have user names for each person you'd like to add to your organization, you can add them to teams.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md
index 0725241ec2..221fd32ac7 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md
@@ -4,6 +4,9 @@ intro: You can cancel all invitations for a person to become an outside collabor
permissions: Organization owners can cancel an invitation to become an outside collaborator in the organization.
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
You can view a list of all people with pending invitations to become an outside collaborator on any repository owned by your organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md
index 81cb2611c5..2e14f7e102 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/canceling-or-editing-an-invitation-to-join-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md b/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md
index d72bc2ee19..262113a3a3 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.types-of-team-visibility %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/changing-the-visibility-of-your-organizations-dependency-insights.md b/content/github/setting-up-and-managing-organizations-and-teams/changing-the-visibility-of-your-organizations-dependency-insights.md
index 1db374fdc1..790a56e104 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/changing-the-visibility-of-your-organizations-dependency-insights.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/changing-the-visibility-of-your-organizations-dependency-insights.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/changing-the-visibility-of-your-organizations-dependency-insights
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can set limitations for viewing organization dependency insights. All members of an organization can view organization dependency insights by default.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-groups-in-organizations.md b/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-groups-in-organizations.md
index d73f270e57..6e4d1b4eed 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-groups-in-organizations.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-groups-in-organizations.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/building-a-strong-community/collaborating-with-your-team.md b/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-your-team.md
similarity index 76%
rename from content/github/building-a-strong-community/collaborating-with-your-team.md
rename to content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-your-team.md
index 6e17a6cece..cb4c12309f 100644
--- a/content/github/building-a-strong-community/collaborating-with-your-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/collaborating-with-your-team.md
@@ -4,9 +4,12 @@ intro: 'Within an organization, your team can work together across projects usin
mapTopic: true
redirect_from:
- /articles/collaborating-with-your-team
+ - /github/building-a-strong-community/collaborating-with-your-team
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md
index 2f34342827..effe8a36c8 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md
@@ -5,6 +5,9 @@ product: '{% data reusables.gated-features.saml-sso %}'
permissions: Organization owners can configure SAML SSO and SCIM using Okta for an organization.
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About SAML and SCIM with Okta
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md
index 4ff72e431c..967d47bdf4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md
@@ -5,6 +5,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.23'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.actions.about-artifact-log-retention %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md
index ab1ebbef74..1196bdc9b3 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/connecting-your-identity-provider-to-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Before [enabling SAML SSO](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) in your {% data variables.product.product_name %} organization, you'll need to connect your identity provider (IdP) to your organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md
index ebda3d0ae0..c706237e94 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md
@@ -7,6 +7,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
You can remove the ability for members of legacy admin teams to create repositories by creating a new team for these members, ensuring that the team has necessary access to the organization's repositories, then deleting the legacy admin team.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md
index f06589eb33..f12e2987df 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md
index 5e15884e40..0d2f02074d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.owners-and-admins-can %} convert organization members into outside collaborators.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
index 55a11392c5..81ece0d1b2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
@@ -7,7 +7,10 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
-permissions: Organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization.
+permissions: 'Organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization.'
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md
index 544e7396b5..1caafa06b9 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md
@@ -8,6 +8,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
You have a few options to convert your legacy Owners team:
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md
index d1d3d1b650..db638bafff 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md
@@ -8,6 +8,9 @@ versions:
redirect_from:
- /articles/creating-a-new-organization-from-scratch
- /admin/user-management/creating-organizations
+topics:
+ - organizations
+ - teams
---
When you create a new organization from scratch, it doesn't have any repositories associated with it. For more information on adding repositories to your organization, see "[Creating a new repository](/articles/creating-a-new-repository)" and "[Transferring a repository](/articles/transferring-a-repository)."
diff --git a/content/github/building-a-strong-community/creating-a-team-discussion.md b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion.md
similarity index 65%
rename from content/github/building-a-strong-community/creating-a-team-discussion.md
rename to content/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion.md
index 0481b6502b..968a93eef7 100644
--- a/content/github/building-a-strong-community/creating-a-team-discussion.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion.md
@@ -3,13 +3,16 @@ title: Creating a team discussion
intro: 'Any organization member can create a _public_ team discussion post. To create a _private_ team discussion post, you must be a member of the team or an organization owner.'
redirect_from:
- /articles/creating-a-team-discussion
+ - /github/building-a-strong-community/creating-a-team-discussion
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
-{% data reusables.organizations.team-discussions-permissions %} For more information, see "[About team discussions](/articles/about-team-discussions)."
+{% data reusables.organizations.team-discussions-permissions %} For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
{% data reusables.profile.access_profile %}
{% data reusables.profile.access_org %}
@@ -24,6 +27,6 @@ versions:
### Further reading
- - "[About team discussions](/articles/about-team-discussions)"
- - "[Editing or deleting a team discussion](/articles/editing-or-deleting-a-team-discussion)"
- - "[Pinning a team discussion](/articles/pinning-a-team-discussion)"
+ - "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)"
+ - "[Editing or deleting a team discussion](/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion)"
+ - "[Pinning a team discussion](/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion)"
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md
index d29be64dc9..4bba443eb8 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Only organization owners and maintainers of a parent team can create a new child team under a parent. Owners can also restrict creation permissions for all teams in an organization. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/deleting-a-team.md b/content/github/setting-up-and-managing-organizations-and-teams/deleting-a-team.md
index bee8b07a10..5509cc6d98 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/deleting-a-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/deleting-a-team.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md b/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md
index d483f8554c..ab490ccd8f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/denying-access-to-a-previously-approved-oauth-app-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/denying-access-to-a-previously-approved-oauth-app-for-your-organization.md
index 0463ce5199..f83e8694c7 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/denying-access-to-a-previously-approved-oauth-app-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/denying-access-to-a-previously-approved-oauth-app-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md
index ed149595e0..0cd8846027 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/disabling-oauth-app-access-restrictions-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% danger %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md
index be68310433..d21c9c8b6f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md
@@ -5,6 +5,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.actions.enterprise-beta %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/disabling-team-discussions-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/disabling-team-discussions-for-your-organization.md
index e4d9e8d55a..99b423896d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/disabling-team-discussions-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/disabling-team-discussions-for-your-organization.md
@@ -7,9 +7,12 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
-{% data reusables.organizations.team-discussions-default %} For more information on team discussions, see "[About team discussions](/articles/about-team-discussions)."
+{% data reusables.organizations.team-discussions-default %} For more information on team discussions, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
{% data reusables.profile.access_profile %}
{% data reusables.profile.access_org %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md b/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md
index bebfbbc2d9..fe2af11379 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md
@@ -7,6 +7,9 @@ redirect_from:
product: '{% data reusables.gated-features.saml-sso %}'
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
Recovery codes should not be shared or distributed. We recommend saving them with a password manager such as [LastPass](https://lastpass.com/), [1Password](https://1password.com/), or [Keeper](https://keepersecurity.com/).
diff --git a/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md b/content/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion.md
similarity index 69%
rename from content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md
rename to content/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion.md
index ba567880e8..7397639d74 100644
--- a/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion.md
@@ -3,10 +3,13 @@ title: Editing or deleting a team discussion
intro: 'Organization members can edit or delete discussions on a team''s page. If you''re an organization member, you can edit or delete the discussion.'
redirect_from:
- /articles/editing-or-deleting-a-team-discussion
+ - /github/building-a-strong-community/editing-or-deleting-a-team-discussion
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% data reusables.profile.access_profile %}
@@ -21,6 +24,6 @@ versions:
### Further reading
- - "[About team discussions](/articles/about-team-discussions)"
- - "[Creating a team discussion](/articles/creating-a-team-discussion)"
- - "[Pinning a team discussion](/articles/pinning-a-team-discussion)"
+ - "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)"
+ - "[Creating a team discussion](/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion)"
+ - "[Pinning a team discussion](/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion)"
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md
index 7de1e9bcd7..8f3fc489a1 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/enabling-and-testing-saml-single-sign-on-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
You can enable SAML SSO in your organization without requiring all members to use it. Enabling but not enforcing SAML SSO in your organization can help smooth your organization's SAML SSO adoption. Once a majority of your organization's members use SAML SSO, you can enforce it within your organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md
index afb7f66b0c..adc8f17827 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/enabling-oauth-app-access-restrictions-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.oauth_app_restrictions_default %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md
index d331a4ca12..08241fc58b 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/enforcing-saml-single-sign-on-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
If you enforce SAML SSO in your organization, any members, including admins who have not authenticated via your SAML identity provider (IdP), will be removed from the organization and will receive an email notifying them about the removal. Bots and service accounts that do not have external identities set up in your organization's IdP will also be removed. For more information on bots and service accounts, see "[Managing bots and service accounts with SAML single sign-on](/articles/managing-bots-and-service-accounts-with-saml-single-sign-on)." You can restore organization members once they successfully complete single sign-on.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md b/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md
index 24808059f5..5153f6a357 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.organizations.team_maintainers_can %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md b/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md
index c0353de939..80c5ff6848 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md
@@ -6,5 +6,8 @@ redirect_from:
- /articles/granting-access-to-your-organization-with-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/index.md b/content/github/setting-up-and-managing-organizations-and-teams/index.md
index a51df67c98..70a9607bb9 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/index.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/index.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
@@ -51,6 +54,11 @@ versions:
{% link_in_list /disabling-team-discussions-for-your-organization %}
{% link_in_list /managing-scheduled-reminders-for-your-team %}
{% link_in_list /deleting-a-team %}
+{% topic_link_in_list /collaborating-with-your-team %}
+ {% link_in_list /about-team-discussions %}
+ {% link_in_list /creating-a-team-discussion %}
+ {% link_in_list /editing-or-deleting-a-team-discussion %}
+ {% link_in_list /pinning-a-team-discussion %}
{% topic_link_in_list /managing-access-to-your-organizations-repositories %}
{% link_in_list /repository-permission-levels-for-an-organization %}
{% link_in_list /setting-base-permissions-for-an-organization %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md
index 0c7304d050..7f2c029ce4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md
@@ -7,6 +7,9 @@ redirect_from:
- /articles/inviting-users-to-join-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md b/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md
index ae816c4de7..62b65b07ce 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md
index 3264533765..76c0456caa 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md
@@ -10,6 +10,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### About maintaining ownership continuity for your organization
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md
index 5d7ab225fd..b15db3e0cc 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
By default, organization members have write access to their organization's project boards unless organization owners or project board admins set different permissions for specific project boards.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md
index 09b911c5fe..722baa5e9d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md
index cd5110e35f..2bdeee3631 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-repositories.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-repositories.md
index b6a9fa4057..ed1fe22a09 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-repositories.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-repositories.md
@@ -10,5 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md
index 197bdfc5be..7b77503d4f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md
@@ -5,6 +5,9 @@ product: '{% data reusables.gated-features.allowed-ip-addresses %}'
versions:
free-pro-team: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can manage allowed IP addresses for an organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md
index cd5207d102..3141574194 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% note %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md
index 194b8f4c9a..f7dcde666d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
People with admin permissions can manage the access of organization members and outside collaborators to an organization repository.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md
index 4cd31df71a..f16c843a4e 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/managing-bots-and-service-accounts-with-saml-single-sign-on
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
To retain access for bots and service accounts, organization administrators can [enable](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization), but **not** [enforce](/articles/enforcing-saml-single-sign-on-for-your-organization) SAML single sign-on for their organization. If you need to enforce SAML single sign-on for your organization, you can create an external identity for the bot or service account with your identity provider (IdP).
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md
index 750351b231..3ba913f229 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md
@@ -6,6 +6,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.20'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Team maintainers and organization owners can configure code review assignments.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md
index cd54ddd0c9..7ec3f9f8c4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.20'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can manage default labels for repositories in the organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md
index 7f6719b4f8..59557ff8e9 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md
@@ -4,6 +4,9 @@ intro: You can choose the permission levels that members require to create discu
permissions: Organization owners can manage discussion creation for repositories owned by the organization.
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.discussions.beta %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md
index 168400ecde..0070b8eba7 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md
@@ -10,5 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md
index 507ee1d405..497c8251f9 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md
index 18cf027e38..64b002f6bf 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md
@@ -8,5 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md
index f21057f972..9d14684e91 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-saml-single-sign-on-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-saml-single-sign-on-for-your-organization.md
index 99753ae9e2..f39fa938c3 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-saml-single-sign-on-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-saml-single-sign-on-for-your-organization.md
@@ -7,5 +7,8 @@ redirect_from:
- /articles/managing-saml-single-sign-on-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md
index 93269f99c4..1d046ad5ee 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md
@@ -3,6 +3,9 @@ title: Managing scheduled reminders for your organization
intro: You can get reminders in Slack for all pull requests that teams in your organization have been requested to review.
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About scheduled reminders for pull requests
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md
index 1be6eb0787..be3b2ef9c0 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md
@@ -5,6 +5,9 @@ redirect_from:
- /github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About scheduled reminders for teams
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md
index e0fc03e983..61d86f76ab 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=3.0'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### About management of security and analysis settings
@@ -26,7 +29,7 @@ versions:
The page that's displayed allows you to enable or disable all security and analysis features for the repositories in your organization.
-{% if currentVersion == "free-pro-team@latest" %}If your organization, or the enterprise that owns it, has a license for {% data variables.product.prodname_GH_advanced_security %}, the page will also contain options to enable and disable {% data variables.product.prodname_advanced_security %} features. Any repositories that use {% data variables.product.prodname_GH_advanced_security %} are listed at the bottom of the page.{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}If your organization belongs to an enterprise with a license for {% data variables.product.prodname_GH_advanced_security %}, the page will also contain options to enable and disable {% data variables.product.prodname_advanced_security %} features. Any repositories that use {% data variables.product.prodname_GH_advanced_security %} are listed at the bottom of the page.{% endif %}
{% if currentVersion ver_gt "enterprise-server@3.0" %}If you have a license for {% data variables.product.prodname_GH_advanced_security %}, the page will also contain options to enable and disable {% data variables.product.prodname_advanced_security %} features. Any repositories that use {% data variables.product.prodname_GH_advanced_security %} are listed at the bottom of the page.{% endif %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md
index d6800f9749..c1659ebf20 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% warning %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md
index 54c73b2ab5..dca7e05e67 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
People with admin access to a repository can manage team access to the repository. Team maintainers can remove a team's access to a repository.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization.md
index 9688d5223d..afbdb5dfe0 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization.md
@@ -10,6 +10,9 @@ permissions: Organization owners can manage team synchronization for an organiza
miniTocMaxHeadingLevel: 4
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.gated-features.okta-team-sync %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md
index 97b52e84e9..d0c412bd38 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md
@@ -6,6 +6,9 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.23'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### About management of the default branch name
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md
index aadb68e9f9..2ea1724010 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can manage the display of member names in an organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md
index 1a56221145..d0c4ef8fe6 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
By default, new organizations are configured to disallow the forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %} and internal{% endif %} repositories.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-publication-of-github-pages-sites-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-publication-of-github-pages-sites-for-your-organization.md
index 184d6d2537..77d90558d2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-the-publication-of-github-pages-sites-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-the-publication-of-github-pages-sites-for-your-organization.md
@@ -9,7 +9,9 @@ versions:
github-ae: '*'
redirect_from:
- /github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization
-
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md
index f60a664644..d849f0d8b8 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md
@@ -4,6 +4,9 @@ intro: You can manage the email address that receives updates from accounts your
versions:
free-pro-team: '*'
permissions: Organization owners can manage updates from accounts the organization sponsors.
+topics:
+ - organizations
+ - teams
---
{% data reusables.sponsors.org-sponsors-release-phase %}
@@ -22,4 +25,4 @@ You can also disable updates from accounts your organization sponsors. For more
### Further reading
-- "[Supporting the open source community with {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors)"
\ No newline at end of file
+- "[Supporting the open source community with {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors)"
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md
index 9a2b443b69..1d363a5cc7 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can manage an organization's SSH certificate authorities (CA).
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md b/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md
index 3a9dfef8fd..47a3e880a4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md
@@ -7,6 +7,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
By default, all organization members can create repositories. If you restrict [repository creation permissions](/articles/restricting-repository-creation-in-your-organization) to organization owners, and your organization was created under the legacy organization permissions structure, members of legacy admin teams will still be able to create repositories.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md b/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md
index 7941a9989c..ccaaf3494e 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md
@@ -10,5 +10,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md b/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md
index 5229466db2..7ffab5946c 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can change the parent of any team. Team maintainers can change a team's parent if they are maintainers in both the child team and the parent team. Team maintainers without maintainer permissions in the child team can request to add a parent or child team. For more information, see "[Requesting to add or change a parent team](/articles/requesting-to-add-or-change-a-parent-team)" and "[Requesting to add a child team](/articles/requesting-to-add-a-child-team)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md b/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md
index fc2ca3c1f7..b820de8bd8 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md
@@ -16,5 +16,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md
index 54c5d401fb..8aa3341d1b 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### Permission levels for an organization
@@ -49,8 +52,8 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late
| @mention any visible team | **X** | **X** | |
| Can be made a *team maintainer* | **X** | **X** | |
| View organization insights (see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization)" for details) | **X** | **X** | |
-| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | |
-| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | |
+| View and post public team discussions to **all teams** (see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)" for details) | **X** | **X** | |
+| View and post private team discussions to **all teams** (see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)" for details) | **X** | | |
| Edit and delete team discussions in **all teams** (see "[Managing disruptive comments](/articles/managing-disruptive-comments)" for details) | **X** | | |
| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | |
| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |
@@ -103,8 +106,8 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late
| Transfer repositories | **X** | |
| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | |
| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | |
-| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | |
-| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | |
+| View and post public team discussions to **all teams** (see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)" for details) | **X** | **X** | |
+| View and post private team discussions to **all teams** (see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)" for details) | **X** | | |
| Edit and delete team discussions in **all teams** (for more information, see "[Managing disruptive comments](/articles/managing-disruptive-comments)) | **X** | | |
| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | **X** |
| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |
@@ -131,7 +134,7 @@ When you designate a user as a {% data variables.product.prodname_github_app %}
### Outside collaborators
-To keep your organization data secure while allowing access to repositories, you can add *outside collaborators*. {% data reusables.organizations.outside_collaborators_description %}
+To keep your organization's data secure while allowing access to repositories, you can add *outside collaborators*. {% data reusables.organizations.outside_collaborators_description %}
### Further reading
diff --git a/content/github/building-a-strong-community/pinning-a-team-discussion.md b/content/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion.md
similarity index 62%
rename from content/github/building-a-strong-community/pinning-a-team-discussion.md
rename to content/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion.md
index 77726b1399..42459e82a6 100644
--- a/content/github/building-a-strong-community/pinning-a-team-discussion.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/pinning-a-team-discussion.md
@@ -3,10 +3,13 @@ title: Pinning a team discussion
intro: 'You can pin important discussions to your organization''s team pages for easy reference, and unpin discussions that are no longer relevant.'
redirect_from:
- /articles/pinning-a-team-discussion
+ - /github/building-a-strong-community/pinning-a-team-discussion
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - community
---
{% data reusables.profile.access_profile %}
@@ -18,6 +21,6 @@ versions:
### Further reading
- - "[About team discussions](/articles/about-team-discussions)"
- - "[Creating a team discussion](/articles/creating-a-team-discussion)"
- - "[Editing or deleting a team discussion](/articles/editing-or-deleting-a-team-discussion)"
+ - "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)"
+ - "[Creating a team discussion](/github/setting-up-and-managing-organizations-and-teams/creating-a-team-discussion)"
+ - "[Editing or deleting a team discussion](/github/setting-up-and-managing-organizations-and-teams/editing-or-deleting-a-team-discussion)"
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md
index 8302c07367..c94b189833 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/preparing-to-enforce-saml-single-sign-on-in-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
When you [enforce SAML single sign-on](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) in your organization, members that haven't authenticated via your identity provider (IdP) will be removed from the organization and will receive an email notifying them about the removal.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md
index 4faf9c6798..8c14803057 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
We recommend that you notify {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} at least one week before you require 2FA in your organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md
index 21d3103029..c774786ca2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### Permissions overview
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md
index 7a8d714fa5..5df6e4477f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md
@@ -7,7 +7,10 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
-permissions: 'Organization owners can reinstate a former member of an organization.'
+permissions: Organization owners can reinstate a former member of an organization.
+topics:
+ - organizations
+ - teams
---
### About member reinstatement
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
index 3608669ae5..042cca36ba 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
@@ -1,6 +1,6 @@
---
title: Reinstating a former outside collaborator's access to your organization
-intro: "You can reinstate a former outside collaborator's access permissions for organization repositories, forks, and settings."
+intro: 'You can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.'
redirect_from:
- /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization
- /articles/reinstating-a-former-outside-collaborators-access-to-your-organization
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
When an outside collaborator's access to your organization's private repositories is removed, the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md
index 16b4fb64bb..cc855248da 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md
@@ -5,6 +5,10 @@ redirect_from:
- /articles/removing-a-billing-manager-from-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
+ - billing
---
{% warning %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md
index 69be72a9b5..27a9d304b2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Only organization owners can remove members from an organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md
index 545cc8145f..8dfd92496e 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-repository.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-repository.md
index d46382fc55..434d773e95 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-repository.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-repository.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md
index 832ccf3cf5..a5f65d7e72 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
For more information about {% data variables.product.prodname_github_app %} manager permissions, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization#github-app-managers)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md b/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md
index 87ec11f1c2..5407d12da3 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.repositories.deleted_forks_from_private_repositories_warning %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md b/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md
index 8df6601909..333b94a9dc 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md
index a0f04df3b9..05a0ab0685 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md
index cdc27e3eaf..8c7fc9d07f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
People with admin permissions can manage individual and team access to an organization-owned repository.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md b/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md
index 82391df281..26a741bfc4 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
When you request to add a team as a child, a request is sent to the maintainers of the child team. Once a maintainer of the child team approves your request, the child team is nested under the parent team in your organization's hierarchy.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md b/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md
index 2f295775c4..df965d01f5 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
When you request to add or change your team's parent, a request is sent to the maintainers of the parent team. When a maintainer of the new parent team approves your request, your team is nested as a child team under the parent team in your organization's hierarchy.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md
index 81fb510f8f..cb8e427fcf 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
### About two-factor authentication for organizations
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md b/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md
index a5156b07c5..e85083f736 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md
@@ -7,5 +7,8 @@ redirect_from:
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md
index 6e0924546a..75f20036b2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md
@@ -7,6 +7,9 @@ redirect_from:
- /articles/restricting-email-notifications-to-an-approved-domain
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About email restrictions
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md
index 1a23b5fc5c..8c3dd0b4e0 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
You can choose whether members can create repositories in your organization. If you allow members to create repositories, you can choose which types of repositories members can create.{% if currentVersion == "free-pro-team@latest" %} To allow members to create private repositories only, your organization must use {% data variables.product.prodname_ghe_cloud %}.{% endif %} For more information, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md
index b2e853ee73..0e9ff0ecde 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
You can restrict the ability to change repository visibility to organization owners only, or allow members with admin privileges for a repository to also change visibility.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
index d8e83edc9d..dfcc61501b 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### Accessing the audit log
@@ -252,7 +255,17 @@ An overview of some of the most common actions that are recorded as events in th
{% endif %}
{% if currentVersion == "free-pro-team@latest" %}
+#### `environment` category actions
+| Action | Description
+|------------------|-------------------
+| `create_actions_secret` | Triggered when a secret is created in an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+| `delete` | Triggered when an environment is deleted. For more information, see ["Deleting an environment](/actions/reference/environments#deleting-an-environment)."
+| `remove_actions_secret` | Triggered when a secret is removed from an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+| `update_actions_secret` | Triggered when a secret in an environment is updated. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)."
+{% endif %}
+
+{% if currentVersion == "free-pro-team@latest" %}
#### `git` category actions
{% note %}
@@ -360,8 +373,10 @@ For more information, see "[Managing the publication of {% data variables.produc
| `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." {% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
| `runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an organization](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)."
| `runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)."
+| `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."
| `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group).
-| `runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group. {% endif %}{% if currentVersion == "free-pro-team@latest"%}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
+| `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)."
+| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% endif %}{% if currentVersion == "free-pro-team@latest"%}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
| `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}
| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
| `update_actions_secret` |Triggered when a {% data variables.product.prodname_actions %} secret is updated.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %}
@@ -473,6 +488,7 @@ For more information, see "[Managing the publication of {% data variables.produc
| Action | Description
|------------------|-------------------
| `access` | Triggered when a user [changes the visibility](/github/administering-a-repository/setting-repository-visibility) of a repository in the organization.
+| `actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not included when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)."
| `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository).
| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository.{% if currentVersion == "free-pro-team@latest" %}
| `advanced_security_disabled` | Triggered when a repository owner disables {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
index ac62de20d3..9250fa7013 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.profile.access_profile %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md
index 10d1f5c9aa..64daf7b01f 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md
@@ -6,6 +6,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
### About base permissions for an organization
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
index e70f55bc64..118d2a24a5 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
@@ -9,6 +9,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md b/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md
index 8634dc39ec..aaa629acd2 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Owners can set permissions for deleting or transferring repositories in an organization.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md
index 6e9c8a7668..522a15d7f5 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Organization owners can set team creation permissions.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md b/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md
index 2729775095..e22599de91 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Unless you set a profile picture for a team, the team profile picture will match the organization's profile picture.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group.md b/content/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group.md
index af65c97ced..b37dc6cb95 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group.md
@@ -6,6 +6,9 @@ permissions: 'Organization owners and team maintainers can synchronize a {% data
versions:
free-pro-team: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
{% data reusables.gated-features.okta-team-sync %}
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md b/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md
index 8cb3565f91..1fc1cea562 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md
@@ -8,6 +8,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
1. If you're the only member with *owner* privileges, give another organization member the owner role. For more information, see "[Appointing an organization owner](/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization#appointing-an-organization-owner)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md
index 95b65b7aea..2d8302bb1d 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/upgrading-to-the-corporate-terms-of-service
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
The Standard Terms of Service is an agreement between {% data variables.product.prodname_dotcom %} and you as an individual. To enter into an agreement with {% data variables.product.prodname_dotcom %} on behalf of an entity, such as a company, non-profit, or group, organization owners can upgrade to the Corporate Terms of Service.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md
index db0098a2c9..2aaf181720 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/verifying-your-organizations-domain
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About domain verification
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md
index c323c79f03..484baa617a 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md
@@ -8,6 +8,9 @@ redirect_from:
- /github/setting-up-and-managing-organizations-and-teams/viewing-and-revoking-organization-members-authorized-access-tokens
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
### About SAML access to your organization
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md b/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md
index 4e18a1b3a6..ff36847928 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/viewing-insights-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - organizations
+ - teams
---
All members of an organization can view organization insights. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/viewing-people-with-access-to-your-repository.md b/content/github/setting-up-and-managing-organizations-and-teams/viewing-people-with-access-to-your-repository.md
index 9e67d74307..eda9a879d3 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/viewing-people-with-access-to-your-repository.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/viewing-people-with-access-to-your-repository.md
@@ -7,6 +7,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - organizations
+ - teams
---
Administrators can use this information to help off-board people, gather data for compliance, and other general security checkups.
diff --git a/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md b/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md
index dd257564d0..3b499d3b26 100644
--- a/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md
+++ b/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - organizations
+ - teams
---
{% note %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md b/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md
index 3322d7a400..1135c38618 100644
--- a/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md
+++ b/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - enterprise
---
### About enterprise accounts
diff --git a/content/github/setting-up-and-managing-your-enterprise/about-identity-and-access-management-for-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/about-identity-and-access-management-for-your-enterprise-account.md
index 056c663408..92325c05be 100644
--- a/content/github/setting-up-and-managing-your-enterprise/about-identity-and-access-management-for-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/about-identity-and-access-management-for-your-enterprise-account.md
@@ -1,9 +1,11 @@
---
title: About identity and access management for your enterprise account
-intro: You can centrally manage access to your enterprise's resources, organization membership, and team membership using your identity provider (IdP).
+intro: 'You can centrally manage access to your enterprise''s resources, organization membership, and team membership using your identity provider (IdP).'
product: '{% data reusables.gated-features.enterprise-accounts %}'
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About identity and access management for your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account.md
index 9ffac5db1a..f98b9981a5 100644
--- a/content/github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account.md
@@ -4,6 +4,8 @@ intro: You can manage organization membership in an enterprise account directly
product: '{% data reusables.gated-features.enterprise-accounts %}'
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise-accounts.user-provisioning-release-stage %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/adding-organizations-to-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/adding-organizations-to-your-enterprise-account.md
index 893493f000..463ae97339 100644
--- a/content/github/setting-up-and-managing-your-enterprise/adding-organizations-to-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/adding-organizations-to-your-enterprise-account.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
Enterprise owners can create new organizations within an enterprise account's settings.
diff --git a/content/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account.md
index 2e1d9a2c7b..19fe6d4cad 100644
--- a/content/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account.md
@@ -1,9 +1,11 @@
---
title: Configuring identity and access management for your enterprise account
-intro: You can manage SAML single sign-on, user provisioning, and team synchronization for your enterprise.
+intro: 'You can manage SAML single sign-on, user provisioning, and team synchronization for your enterprise.'
product: '{% data reusables.gated-features.enterprise-accounts %}'
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
diff --git a/content/github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta.md b/content/github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta.md
index b1fd95b884..a3ed7851ea 100644
--- a/content/github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta.md
+++ b/content/github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
{% data reusables.enterprise-accounts.user-provisioning-release-stage %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md
index 5284cd63a3..bf16b25a80 100644
--- a/content/github/setting-up-and-managing-your-enterprise/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.23'
github-ae: '*'
+topics:
+ - enterprise
---
{% data reusables.actions.about-artifact-log-retention %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/configuring-webhooks-for-organization-events-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/configuring-webhooks-for-organization-events-in-your-enterprise-account.md
index 9aeb15a046..51a4749ae6 100644
--- a/content/github/setting-up-and-managing-your-enterprise/configuring-webhooks-for-organization-events-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/configuring-webhooks-for-organization-events-in-your-enterprise-account.md
@@ -8,6 +8,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/configuring-webhooks-for-organization-events-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
You can configure webhooks to receive events from organizations owned by your enterprise account. For more information about webhooks, see "[Webhooks](/webhooks/)."
diff --git a/content/github/setting-up-and-managing-your-enterprise/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account.md
index 0e002776cb..4743ba484e 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account.md
@@ -5,6 +5,8 @@ product: '{% data reusables.gated-features.enterprise-accounts %}'
permissions: Enterprise owners can enable SAML single sign-on for organizations in an enterprise account.
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About SAML single sign-on for enterprise accounts
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md
index 036f99a198..e2333feeee 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md
@@ -8,6 +8,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
In organizations owned by an enterprise account, organization owners can set limitations for viewing organization dependency insights. For more information, see "[Changing the visibility of your organization's dependency insights](/articles/changing-the-visibility-of-your-organizations-dependency-insights)."
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-github-actions-policies-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-github-actions-policies-in-your-enterprise-account.md
index 7ef386c2ae..99413f99b7 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-github-actions-policies-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-github-actions-policies-in-your-enterprise-account.md
@@ -7,6 +7,8 @@ redirect_from:
miniTocMaxHeadingLevel: 4
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.prodname_actions %} permissions for your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-project-board-policies-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-project-board-policies-in-your-enterprise-account.md
index 2b1f5bec09..fc56be779a 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-project-board-policies-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-project-board-policies-in-your-enterprise-account.md
@@ -9,6 +9,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
For more information about types of project boards, see "[About project boards](/articles/about-project-boards)."
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account.md
index f5e9e4c082..c3becba29a 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account.md
@@ -9,6 +9,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
For more information, see "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)."
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-security-settings-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-security-settings-in-your-enterprise-account.md
index 2b0f109f96..8271ab0077 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-security-settings-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-security-settings-in-your-enterprise-account.md
@@ -11,6 +11,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### Requiring two-factor authentication for organizations in your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/enforcing-team-policies-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/enforcing-team-policies-in-your-enterprise-account.md
index 6d95d38f9f..cbe70eef28 100644
--- a/content/github/setting-up-and-managing-your-enterprise/enforcing-team-policies-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/enforcing-team-policies-in-your-enterprise-account.md
@@ -9,11 +9,13 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### Enforcing a policy for team discussions
-Across all organizations owned by your enterprise account, you can enable or disable team discussions, or allow owners to administer the setting on the organization level. For more information, see "[About team discussions](/articles/about-team-discussions/)."
+Across all organizations owned by your enterprise account, you can enable or disable team discussions, or allow owners to administer the setting on the organization level. For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions/)."
{% data reusables.enterprise-accounts.access-enterprise %}
{% data reusables.enterprise-accounts.policies-tab %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/index.md b/content/github/setting-up-and-managing-your-enterprise/index.md
index a0f04ad09c..e6f5d91294 100644
--- a/content/github/setting-up-and-managing-your-enterprise/index.md
+++ b/content/github/setting-up-and-managing-your-enterprise/index.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
diff --git a/content/github/setting-up-and-managing-your-enterprise/inviting-people-to-manage-your-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/inviting-people-to-manage-your-enterprise.md
index 5f847dd348..e25cf3136e 100644
--- a/content/github/setting-up-and-managing-your-enterprise/inviting-people-to-manage-your-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/inviting-people-to-manage-your-enterprise.md
@@ -9,6 +9,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - enterprise
---
### About inviting people to manage your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md
index 6a02ac8400..6596a04d44 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md
@@ -9,6 +9,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About {% data variables.product.prodname_vss_ghe %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account.md
index 9045814fc6..64cb68fdcb 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account.md
@@ -7,4 +7,7 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/managing-organizations-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account.md
index a8ce59ba50..ef3f0b988a 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account.md
@@ -5,6 +5,8 @@ product: '{% data reusables.gated-features.enterprise-accounts %}'
permissions: Enterprise owners can manage team synchronization for an enterprise account.
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About team synchronization for enterprise accounts
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-unowned-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/managing-unowned-organizations-in-your-enterprise-account.md
index 5b1ed4ce48..1c3f9e78b5 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-unowned-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-unowned-organizations-in-your-enterprise-account.md
@@ -7,6 +7,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/managing-unowned-organizations-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
If you enable user deprovisioning to manage organization membership in your enterprise account, you could end up with an organization that has no organization owners. For more information, see "[About user provisioning for organizations in your enterprise account](/github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account)."
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise.md
index 6ccf673df3..b5a764d7bc 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise.md
@@ -11,4 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account.md
index 348926c13c..143d0baadd 100644
--- a/content/github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account.md
@@ -7,5 +7,7 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - enterprise
---
diff --git a/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md
index 8e2f45146e..651e15af7b 100644
--- a/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md
+++ b/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md
@@ -1,10 +1,12 @@
---
title: Restricting email notifications for your enterprise account to approved domains
-intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains."
+intro: You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains.
product: '{% data reusables.gated-features.enterprise-accounts %}'
versions:
free-pro-team: '*'
permissions: Enterprise owners can restrict email notifications for an enterprise account.
+topics:
+ - enterprise
---
### About email restrictions for your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise.md
index a0323d4f21..bc2568895a 100644
--- a/content/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### About roles in an enterprise
diff --git a/content/github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account.md
index 27d125ccd8..1295569fe5 100644
--- a/content/github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account.md
@@ -7,4 +7,7 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/setting-policies-for-organizations-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
+
diff --git a/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md
index a417a7df78..96714ca44c 100644
--- a/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md
+++ b/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md
@@ -8,6 +8,8 @@ permissions: Enterprise owners can verify an enterprise account's domain.
redirect_from:
- /github/articles/verifying-your-enterprise-accounts-domain
- /early-access/github/articles/verifying-your-enterprise-accounts-domain
+topics:
+ - enterprise
---
### About domain verification
@@ -39,4 +41,4 @@ To verify your enterprise account's domain, you must have access to modify domai
```
{% data reusables.organizations.continue-verifying-domain %}
1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service.
-
\ No newline at end of file
+
diff --git a/content/github/setting-up-and-managing-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise.md
index 8ec6200f48..79372cb903 100644
--- a/content/github/setting-up-and-managing-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise.md
@@ -8,6 +8,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
### About SAML access to your enterprise account
diff --git a/content/github/setting-up-and-managing-your-enterprise/viewing-people-in-your-enterprise.md b/content/github/setting-up-and-managing-your-enterprise/viewing-people-in-your-enterprise.md
index 3b1bdfe5b3..8ffa84213a 100644
--- a/content/github/setting-up-and-managing-your-enterprise/viewing-people-in-your-enterprise.md
+++ b/content/github/setting-up-and-managing-your-enterprise/viewing-people-in-your-enterprise.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - enterprise
---
### Viewing enterprise owners{% if currentVersion == "free-pro-team@latest" %} and billing managers{% endif %}
diff --git a/content/github/setting-up-and-managing-your-enterprise/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md
index b63394ccd3..4227e55e42 100644
--- a/content/github/setting-up-and-managing-your-enterprise/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md
@@ -8,6 +8,8 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account
versions:
free-pro-team: '*'
+topics:
+ - enterprise
---
Each audit log entry shows applicable information about an event, such as:
diff --git a/content/github/setting-up-and-managing-your-enterprise/viewing-the-subscription-and-usage-for-your-enterprise-account.md b/content/github/setting-up-and-managing-your-enterprise/viewing-the-subscription-and-usage-for-your-enterprise-account.md
index d245317800..452442dbdd 100644
--- a/content/github/setting-up-and-managing-your-enterprise/viewing-the-subscription-and-usage-for-your-enterprise-account.md
+++ b/content/github/setting-up-and-managing-your-enterprise/viewing-the-subscription-and-usage-for-your-enterprise-account.md
@@ -2,13 +2,15 @@
title: Viewing the subscription and usage for your enterprise account
intro: 'You can view the current subscription, license usage, invoices, payment history, and other billing information for your enterprise account.'
product: '{% data reusables.gated-features.enterprise-accounts %}'
-permissions: 'Enterprise owners and billing managers can access and manage all billing settings for enterprise accounts.'
+permissions: Enterprise owners and billing managers can access and manage all billing settings for enterprise accounts.
redirect_from:
- /github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account
- /articles/viewing-the-subscription-and-usage-for-your-enterprise-account
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - enterprise
---
### About billing for enterprise accounts
diff --git a/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md b/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md
index d5b5bcbbf2..0a158f8e14 100644
--- a/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
You can optionally choose to add a description, location, website, and email address for your organization, and pin important repositories to the top of the page.
diff --git a/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md
index b2ba70604a..6d98ca7dbf 100644
--- a/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
You can add personal information about yourself in your bio, like previous places you've worked, projects you've contributed to, or interests you have that other people may like to know about. For more information, see "[Adding a bio to your profile](/articles/personalizing-your-profile/#adding-a-bio-to-your-profile)."
diff --git a/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md
index 6a1a2d651a..529e65c64d 100644
--- a/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
diff --git a/content/github/setting-up-and-managing-your-github-profile/index.md b/content/github/setting-up-and-managing-your-github-profile/index.md
index b6ef2bc555..65df71a043 100644
--- a/content/github/setting-up-and-managing-your-github-profile/index.md
+++ b/content/github/setting-up-and-managing-your-github-profile/index.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
diff --git a/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md
index e12a79ddba..54d688fdac 100644
--- a/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
diff --git a/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md b/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md
index 9829c4a9ac..32ed768480 100644
--- a/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md
+++ b/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md
@@ -4,6 +4,8 @@ intro: 'You can add a README to your {% data variables.product.prodname_dotcom %
versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
+topics:
+ - profiles
---
### About your profile README
diff --git a/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md
index 1845388433..b5cdcf5792 100644
--- a/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
### Changing your profile picture
diff --git a/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md
index 99905412a6..9ad1c75672 100644
--- a/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md
@@ -1,12 +1,14 @@
---
title: Pinning items to your profile
-intro: 'You can pin gists and repositories to your profile so other people can quickly see your best work.'
+intro: You can pin gists and repositories to your profile so other people can quickly see your best work.
redirect_from:
- /articles/pinning-repositories-to-your-profile/
- /articles/pinning-items-to-your-profile
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - profiles
---
You can pin a public repository if you own the repository or you've made contributions to the repository. Commits to forks don't count as contributions, so you can't pin a fork that you don't own. For more information, see "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"
diff --git a/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md
index a4fb392c7b..9f0ba1abbf 100644
--- a/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
If you publicize your private contributions, people without access to the private repositories you work in won't be able to see the details of your private contributions. Instead, they'll see the number of private contributions you made on any given day. Your public contributions will include detailed information. For more information, see "[Viewing contributions on your profile page](/articles/viewing-contributions-on-your-profile-page)".
diff --git a/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md b/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md
index a81413352b..80ff1b97b7 100644
--- a/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - profiles
---
{% note %}
diff --git a/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md
index a7fc39ffc8..93f96972bb 100644
--- a/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
{% data reusables.profile.activity-overview-summary %} For more information, see "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)."
diff --git a/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md b/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md
index c175ed7288..786fe7da85 100644
--- a/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md
+++ b/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
### Expected behavior to view commit details
diff --git a/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md b/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md
index 2620b22569..08de8cfc3e 100644
--- a/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Your contribution graph shows activity from public repositories. {% endif %}You can choose to show activity from {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}both public and {% endif %}private repositories, with specific details of your activity in private repositories anonymized. For more information, see "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)."
diff --git a/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md
index b03f183b73..84d3bddd57 100644
--- a/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md
+++ b/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - profiles
---
### Contributions that are counted
diff --git a/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md b/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md
index 26871dae11..cb1ddd422b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
An organization owner can invite you to join their organization as a member, billing manager, or owner. An organization owner or member with admin privileges for a repository can invite you to collaborate in one or more repositories as an outside collaborator. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
diff --git a/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md b/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md
index 56bc439f15..8eb29afb79 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
### Accessing your personal dashboard
diff --git a/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md b/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md
index d02c1a7a1b..f47c140a3b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md b/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md
index c72f08f6d5..2ad2b2a46c 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
+ - notifications
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md b/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md
index 923402231b..9bba3b05ed 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/best-practices-for-leaving-your-company
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
Before you leave your company, make sure you update the following information in your user account:
diff --git a/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md b/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md
index a61ec05adb..13dfbff92f 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/blocking-command-line-pushes-that-expose-your-personal-email-address
versions:
free-pro-team: '*'
+topics:
+ - accounts
+ - notifications
---
When you push commits from the command line, the email address that you've [set in Git](/articles/setting-your-commit-email-address) is associated with your commits. This setting blocks you from pushing commits on the command line that use your personal email address.
diff --git a/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
index 8140f49101..08ec06aef5 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
@@ -10,6 +10,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
---
### About username changes
diff --git a/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md
index 7704249f86..c5e362db8d 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md
@@ -6,6 +6,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
+ - notifications
---
{% note %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md
index 9094888ead..73250f620d 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md
@@ -8,6 +8,8 @@ intro: You can convert your user account into an organization. This allows more
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
---
{% warning %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md b/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md
index 2073ac5e5e..b8177c6b3b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md
@@ -7,6 +7,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
---
Deleting your user account removes all repositories, forks of private repositories, wikis, issues, pull requests, and pages owned by your account. {% if currentVersion == "free-pro-team@latest" %} Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted - instead, they'll be associated with our [Ghost user](https://github.com/ghost).{% else %}Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted.{% endif %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/index.md b/content/github/setting-up-and-managing-your-github-user-account/index.md
index 352849bd57..550c5b1f3b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/index.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/index.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md b/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md
index 8d3b6a831b..ce6539cb9d 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md
@@ -10,6 +10,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - repositories
---
Repositories owned by an organization can grant more granular access. For more information, see "[Access permissions on {% data variables.product.product_name %}](/articles/access-permissions-on-github)."
diff --git a/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md b/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md
index a01d522898..9e18f58d24 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md
@@ -3,6 +3,9 @@ title: Maintaining ownership continuity of your user account's repositories
intro: You can invite someone to manage your user owned repositories if you are not able to.
versions:
free-pro-team: '*'
+topics:
+ - accounts
+ - repositories
---
### About successors
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories.md b/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories.md
index 4676b8aeae..eb7faf4527 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories.md
@@ -11,5 +11,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - repositories
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md
index ea304c8f15..223fdd8e99 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
A collaborator is a person who has permissions to a project board you own. A collaborator's permissions will default to read access. For more information, see "[Permission levels for user-owned project boards](/articles/permission-levels-for-user-owned-project-boards)."
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md b/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md
index b53a647506..0b29ed6699 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md
@@ -9,5 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - notifications
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md b/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md
index 04633f58fd..7dcd5e60c2 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/managing-marketing-emails-from-github
versions:
free-pro-team: '*'
+topics:
+ - accounts
+ - notifications
---
### Unsubscribing from {% data variables.product.prodname_dotcom %} marketing emails
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md b/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md
index 442ab7153d..d28e5fb58a 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md
@@ -3,6 +3,8 @@ title: Managing security and analysis settings for your user account
intro: 'You can control features that secure and analyze the code in your projects on {% data variables.product.prodname_dotcom %}.'
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
### About management of security and analysis settings
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md
index 0524ab40ce..b199768a7b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.23'
github-ae: '*'
+topics:
+ - accounts
---
### About management of the default branch name
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md b/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md
index 3e31dd2814..fcbe11a0a4 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md
@@ -10,5 +10,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md b/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md
index 80a10eb4a8..37b22a88d8 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md b/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md
index 0cb96a4754..2284aaf647 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md
@@ -3,6 +3,8 @@ title: Managing your scheduled reminders
intro: Get reminders in Slack when you or your team have pull requests waiting for review.
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
### About scheduled reminders for users
diff --git a/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md b/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md
index 93091a6db3..609bb5e5a3 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md
@@ -1,8 +1,10 @@
---
title: Managing your theme settings
-intro: You can manage how {% data variables.product.product_name %} looks to you by setting a theme preference that either follows your system settings or always uses light mode or dark mode.
+intro: 'You can manage how {% data variables.product.product_name %} looks to you by setting a theme preference that either follows your system settings or always uses light mode or dark mode.'
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
{% note %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md b/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md
index 6939ca2d09..6882f942b3 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/merging-multiple-user-accounts
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
{% tip %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
index 4906f2934f..1c52e2bd81 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
### About permissions levels for a user account repository
diff --git a/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md b/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md
index d77c697386..8c834e7dad 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
### Permissions overview
diff --git a/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md b/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md
index 5eda5de372..97cdce17af 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
diff --git a/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md b/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md
index d9e43ab812..a438da5c1b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md
@@ -8,6 +8,9 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - accounts
+ - notifications
---
{% mac %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md b/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md
index 34e08f8885..a1aa21b439 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md
@@ -13,6 +13,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - repositories
---
### Deleting forks of private repositories
diff --git a/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md b/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md
index 5a5c84520d..aec4a67b0f 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md
@@ -12,6 +12,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - repositories
---
{% data reusables.user_settings.access_settings %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md b/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md
index 0a90a82e59..8b37bf683b 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md b/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md
index 1ffc7304d1..c4a4c40a9f 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md
@@ -7,6 +7,8 @@ redirect_from:
- /articles/requesting-organization-approval-for-oauth-apps
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
### Requesting organization approval for an {% data variables.product.prodname_oauth_app %} you've already authorized for your personal account
diff --git a/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md b/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md
index e43a3ba4e4..d29f41ccea 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md
@@ -1,12 +1,15 @@
---
title: Setting a backup email address
-intro: Use a backup email address as an additional destination for security-relevant account notifications{% if currentVersion != "github-ae@latest" %} and to securely reset your password if you can no longer access your primary email address{% endif %}.
+intro: 'Use a backup email address as an additional destination for security-relevant account notifications{% if currentVersion != "github-ae@latest" %} and to securely reset your password if you can no longer access your primary email address{% endif %}.'
redirect_from:
- /articles/setting-a-backup-email-address
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - notifications
---
{% data reusables.user_settings.access_settings %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md b/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md
index efc2bc6f58..c2ee6b124f 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md
@@ -14,6 +14,9 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
+ - notifications
---
### About commit email addresses
diff --git a/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md b/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md
index 48115cd1c3..6fcfee0db7 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/types-of-emails-github-sends
versions:
free-pro-team: '*'
+topics:
+ - accounts
+ - notifications
---
### Notification emails
diff --git a/content/github/setting-up-and-managing-your-github-user-account/viewing-peoples-roles-in-an-organization.md b/content/github/setting-up-and-managing-your-github-user-account/viewing-peoples-roles-in-an-organization.md
index 3e366d76a8..6e5cb96277 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/viewing-peoples-roles-in-an-organization.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/viewing-peoples-roles-in-an-organization.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - accounts
---
{% note %}
diff --git a/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md b/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md
index d6a14d6120..f878c2ad80 100644
--- a/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md
+++ b/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/what-does-the-available-for-hire-checkbox-do
versions:
free-pro-team: '*'
+topics:
+ - accounts
---
The [GitHub Jobs](https://jobs.github.com/) board is a great way to find employment in tech. You can opt to see jobs posted there on your GitHub dashboard.
diff --git a/content/github/site-policy/dmca-takedown-policy.md b/content/github/site-policy/dmca-takedown-policy.md
index c73627ff5d..449c6d616c 100644
--- a/content/github/site-policy/dmca-takedown-policy.md
+++ b/content/github/site-policy/dmca-takedown-policy.md
@@ -8,6 +8,9 @@ redirect_from:
- /articles/dmca-takedown-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Welcome to GitHub's Guide to the Digital Millennium Copyright Act, commonly known as the "DMCA." This page is not meant as a comprehensive primer to the statute. However, if you've received a DMCA takedown notice targeting content you've posted on GitHub or if you're a rights-holder looking to issue such a notice, this page will hopefully help to demystify the law a bit as well as our policies for complying with it.
diff --git a/content/github/site-policy/github-acceptable-use-policies.md b/content/github/site-policy/github-acceptable-use-policies.md
index 0ed0d7ec13..ff37a78d38 100644
--- a/content/github/site-policy/github-acceptable-use-policies.md
+++ b/content/github/site-policy/github-acceptable-use-policies.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-acceptable-use-policies
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
**Short version:** _We host a wide variety of collaborative projects from all over the world, and that collaboration only works when our users are able to work together in good faith. While using the Service, you must comply with our Acceptable Use Policies, which include some restrictions on content you can post, conduct on the service, and other limitations. In short, be excellent to each other._
diff --git a/content/github/site-policy/github-additional-product-terms.md b/content/github/site-policy/github-additional-product-terms.md
index 48b68a79f8..7c6d29ca79 100644
--- a/content/github/site-policy/github-additional-product-terms.md
+++ b/content/github/site-policy/github-additional-product-terms.md
@@ -2,6 +2,9 @@
title: GitHub Additional Product Terms
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Version Effective Date: February 22, 2021
diff --git a/content/github/site-policy/github-and-trade-controls.md b/content/github/site-policy/github-and-trade-controls.md
index aff71cd6e9..a8cbb44eb8 100644
--- a/content/github/site-policy/github-and-trade-controls.md
+++ b/content/github/site-policy/github-and-trade-controls.md
@@ -7,6 +7,9 @@ redirect_from:
- /github/site-policy/github-and-export-controls
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub.com, GitHub Enterprise Server, and the information you upload to either product may be subject to trade control regulations, including under the U.S. Export Administration Regulations (the EAR).
diff --git a/content/github/site-policy/github-anti-bribery-statement.md b/content/github/site-policy/github-anti-bribery-statement.md
index 0b66ee43c5..b78ee543f6 100644
--- a/content/github/site-policy/github-anti-bribery-statement.md
+++ b/content/github/site-policy/github-anti-bribery-statement.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-anti-bribery-statement
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub upholds our commitment to ethical business practices, including by prohibiting bribery and corruption. As [Transparency International](https://www.transparency.org/what-is-corruption#costs-of-corruption) explains, the costs of corruption are
- **political**, by posing a major obstacle to democracy and the rule of law
diff --git a/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md b/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md
index 97bff67a75..0a63b70043 100644
--- a/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md
+++ b/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-bug-bounty-program-legal-safe-harbor
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### Summary
diff --git a/content/github/site-policy/github-candidate-privacy-policy.md b/content/github/site-policy/github-candidate-privacy-policy.md
index 1b570f1a82..b329a301ed 100644
--- a/content/github/site-policy/github-candidate-privacy-policy.md
+++ b/content/github/site-policy/github-candidate-privacy-policy.md
@@ -2,6 +2,9 @@
title: GitHub Candidate Privacy Policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Effective Date: March 8, 2021
diff --git a/content/github/site-policy/github-community-forum-code-of-conduct.md b/content/github/site-policy/github-community-forum-code-of-conduct.md
index edffc306ec..aa9b32dd80 100644
--- a/content/github/site-policy/github-community-forum-code-of-conduct.md
+++ b/content/github/site-policy/github-community-forum-code-of-conduct.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-community-forum-code-of-conduct
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### Overview and Purpose
diff --git a/content/github/site-policy/github-community-guidelines.md b/content/github/site-policy/github-community-guidelines.md
index 3e82aa45b7..29faa59f3b 100644
--- a/content/github/site-policy/github-community-guidelines.md
+++ b/content/github/site-policy/github-community-guidelines.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/github-community-guidelines
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Millions of developers host millions of projects on GitHub — both open and closed source — and we're honored to play a part in enabling collaboration across the community every day. Together, we all have an exciting opportunity and responsibility to make this a community we can be proud of.
diff --git a/content/github/site-policy/github-corporate-terms-of-service.md b/content/github/site-policy/github-corporate-terms-of-service.md
index 9139ffcb29..da405f50f0 100644
--- a/content/github/site-policy/github-corporate-terms-of-service.md
+++ b/content/github/site-policy/github-corporate-terms-of-service.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-corporate-terms-of-service
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
THANK YOU FOR CHOOSING GITHUB FOR YOUR COMPANY’S BUSINESS NEEDS. PLEASE READ THIS AGREEMENT CAREFULLY AS IT GOVERNS USE OF THE PRODUCTS (AS DEFINED BELOW), UNLESS GITHUB HAS EXECUTED A SEPARATE WRITTEN AGREEMENT WITH CUSTOMER FOR THAT PURPOSE.
diff --git a/content/github/site-policy/github-deceased-user-policy.md b/content/github/site-policy/github-deceased-user-policy.md
index af27d5a37d..70a7a11a20 100644
--- a/content/github/site-policy/github-deceased-user-policy.md
+++ b/content/github/site-policy/github-deceased-user-policy.md
@@ -2,6 +2,9 @@
title: GitHub Deceased User Policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
In the event that a GitHub user passes away, we can work with an authorized individual to determine what happens to the account's content.
diff --git a/content/github/site-policy/github-event-code-of-conduct.md b/content/github/site-policy/github-event-code-of-conduct.md
index 9610d2f73e..c52346dc67 100644
--- a/content/github/site-policy/github-event-code-of-conduct.md
+++ b/content/github/site-policy/github-event-code-of-conduct.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-event-code-of-conduct
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub events are community events intended for networking and collaboration in the tech community.
diff --git a/content/github/site-policy/github-event-terms.md b/content/github/site-policy/github-event-terms.md
index 6e8c43ce05..5145ee3b6c 100644
--- a/content/github/site-policy/github-event-terms.md
+++ b/content/github/site-policy/github-event-terms.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-event-terms
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
By RSVP'ing to or attending a GitHub event, including any of the events or activities organized by GitHub in association with the GitHub event (collectively the "Event"), you signal that you have read, understand, and agree to the following Event Terms and Conditions.
diff --git a/content/github/site-policy/github-gifts-and-entertainment-policy.md b/content/github/site-policy/github-gifts-and-entertainment-policy.md
index 9cfae9d2b9..1daaf9078e 100644
--- a/content/github/site-policy/github-gifts-and-entertainment-policy.md
+++ b/content/github/site-policy/github-gifts-and-entertainment-policy.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-gifts-and-entertainment-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub recognizes that our business is built on positive and transparent relationships. While informal interactions and exchanges of gifts may be part of developing those relationships and may even be considered customary in some countries, we need to ensure that we’re following anti-bribery laws. We have a legal obligation to behave ethically, including by not using such interactions to create a special advantage or influence a deal.
diff --git a/content/github/site-policy/github-government-takedown-policy.md b/content/github/site-policy/github-government-takedown-policy.md
index 23c2723731..830528e58a 100644
--- a/content/github/site-policy/github-government-takedown-policy.md
+++ b/content/github/site-policy/github-government-takedown-policy.md
@@ -2,6 +2,9 @@
title: GitHub Government Takedown Policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
#### What is this?
From time to time, GitHub receives requests from governments to remove content that has been declared unlawful in their local jurisdiction. Although we may not always agree with those laws, we may need to block content if we receive a complete request from a government official so that our users in that jurisdiction may continue to have access to GitHub to collaborate and build software.
diff --git a/content/github/site-policy/github-gpl-cooperation-commitment.md b/content/github/site-policy/github-gpl-cooperation-commitment.md
index b0129962bf..db08f7cc2f 100644
--- a/content/github/site-policy/github-gpl-cooperation-commitment.md
+++ b/content/github/site-policy/github-gpl-cooperation-commitment.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-gpl-cooperation-commitment
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
This commitment pertains to GitHub contributions to Git, the Linux kernel, and other programs under covered licenses (scroll to the end for definitions).
diff --git a/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
index 70d4eb12aa..a4b4d3fc5e 100644
--- a/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
+++ b/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
@@ -9,6 +9,9 @@ redirect_from:
- /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement.
diff --git a/content/github/site-policy/github-logo-policy.md b/content/github/site-policy/github-logo-policy.md
index 2e09b76469..ce0de00a56 100644
--- a/content/github/site-policy/github-logo-policy.md
+++ b/content/github/site-policy/github-logo-policy.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/github-logo-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
You can add {% data variables.product.prodname_dotcom %} logos to your website or third-party application in some scenarios. For more information and specific guidelines on logo usage, see the [{% data variables.product.prodname_dotcom %} Logos and Usage page](https://github.com/logos).
diff --git a/content/github/site-policy/github-marketplace-developer-agreement.md b/content/github/site-policy/github-marketplace-developer-agreement.md
index d92ec43248..1db5534558 100644
--- a/content/github/site-policy/github-marketplace-developer-agreement.md
+++ b/content/github/site-policy/github-marketplace-developer-agreement.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-marketplace-developer-agreement
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
**THESE TERMS AND CONDITIONS (THE "AGREEMENT") GOVERN YOUR PARTICIPATION IN GITHUB’S MARKETPLACE PROGRAM. BY ENROLLING TO PARTICIPATE IN THE MARKETPLACE PROGRAM OR BY CLICKING “I ACCEPT” BELOW, YOU ARE CONFIRMING THAT YOU UNDERSTAND THIS AGREEMENT, AND THAT YOU ACCEPT ALL OF ITS TERMS AND CONDITIONS. IF YOU ARE ENTERING INTO THIS AGREEMENT ON BEHALF OF A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THE ENTITY TO THIS AGREEMENT, IN WHICH CASE “YOU” WILL MEAN THE ENTITY YOU REPRESENT.**
diff --git a/content/github/site-policy/github-marketplace-terms-of-service.md b/content/github/site-policy/github-marketplace-terms-of-service.md
index 2d3b9ed203..63e80b6c36 100644
--- a/content/github/site-policy/github-marketplace-terms-of-service.md
+++ b/content/github/site-policy/github-marketplace-terms-of-service.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-marketplace-terms-of-service
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Welcome to GitHub Marketplace ("Marketplace")! We're happy you're here. Please read these Terms of Service ("Marketplace Terms") carefully before accessing or using GitHub Marketplace. GitHub Marketplace is a platform that allows you to select developer apps or actions (for free or for a charge) that can be used with your GitHub.com account ("Developer Products"). Although offered by GitHub, Inc. ("GitHub", "we", "us"), Developer Products may be developed and maintained by either GitHub or by third-party software providers. Your selection or use of Developer Products is subject to these Marketplace Terms and any applicable fees, and may require you to agree to additional terms as provided by the third party licensor of that Developer Product (the "Product Provider").
diff --git a/content/github/site-policy/github-open-source-applications-terms-and-conditions.md b/content/github/site-policy/github-open-source-applications-terms-and-conditions.md
index 4b2b6ba059..d6f59db4b7 100644
--- a/content/github/site-policy/github-open-source-applications-terms-and-conditions.md
+++ b/content/github/site-policy/github-open-source-applications-terms-and-conditions.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-open-source-applications-terms-and-conditions
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
These GitHub Open Source Applications Terms and Conditions ("Application Terms") are a legal agreement between you (either as an individual or on behalf of an entity) and GitHub, Inc. regarding your use of GitHub's applications, such as GitHub Desktop™ and associated documentation ("Software"). These Application Terms apply to the executable code version of the Software. Source code for the Software is available separately and free of charge under open source software license agreements. If you do not agree to all of the terms in these Application Terms, do not download, install, use, or copy the Software.
diff --git a/content/github/site-policy/github-pre-release-program.md b/content/github/site-policy/github-pre-release-program.md
index dc6f74153f..b9c0617da3 100644
--- a/content/github/site-policy/github-pre-release-program.md
+++ b/content/github/site-policy/github-pre-release-program.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-pre-release-program
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Thanks for signing up to participate in GitHub pre-release programs! As a trusted member of our community, your feedback on new and experimental features is important to us. In order to share these new products and services with you – many of which are still secret and in development – we’ll need you to agree to a special set of terms. Welcome to the Pre-release Program Agreement (“Agreement”).
diff --git a/content/github/site-policy/github-privacy-statement.md b/content/github/site-policy/github-privacy-statement.md
index 7dbbaa9dc1..52c319b8e4 100644
--- a/content/github/site-policy/github-privacy-statement.md
+++ b/content/github/site-policy/github-privacy-statement.md
@@ -9,6 +9,9 @@ redirect_from:
- /articles/github-privacy-statement/
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Effective date: December 19, 2020
diff --git a/content/github/site-policy/github-private-information-removal-policy.md b/content/github/site-policy/github-private-information-removal-policy.md
index 69e4d996c8..f2afae3359 100644
--- a/content/github/site-policy/github-private-information-removal-policy.md
+++ b/content/github/site-policy/github-private-information-removal-policy.md
@@ -5,6 +5,9 @@ redirect_from:
- /github/site-policy/github-sensitive-data-removal-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
We offer this private information removal process as an exceptional service only for high-risk content that violates [GitHub's Terms of Service](/github/site-policy/github-acceptable-use-policies#3-conduct-restrictions), such as when your security is at risk from exposed access credentials. This guide describes the information GitHub needs from you in order to process a request to remove private information from a repository.
diff --git a/content/github/site-policy/github-registered-developer-agreement.md b/content/github/site-policy/github-registered-developer-agreement.md
index a28e956a51..f3c3a6cde9 100644
--- a/content/github/site-policy/github-registered-developer-agreement.md
+++ b/content/github/site-policy/github-registered-developer-agreement.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-registered-developer-agreement
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub is fortunate to have many developers integrating with our platform. We think that’s awesome, and we want to make that experience even better. GitHub’s Developer Program (the “Program”) helps us to connect with you, share information with you, and support your creative efforts better than ever before. The special relationship between GitHub and the developer community that the Program creates requires a special set of terms. Welcome to the Registered Developer Agreement (“Agreement”).
diff --git a/content/github/site-policy/github-research-program-terms.md b/content/github/site-policy/github-research-program-terms.md
index f16cccc3d9..cebfafa12d 100644
--- a/content/github/site-policy/github-research-program-terms.md
+++ b/content/github/site-policy/github-research-program-terms.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-research-program-terms
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Welcome to the GitHub Research Program (the "Program")! To participate, we’ll need you to agree to a special set of terms, the GitHub Research Program Agreement (“Agreement”).
diff --git a/content/github/site-policy/github-sponsors-additional-terms.md b/content/github/site-policy/github-sponsors-additional-terms.md
index 343c68a35c..060865d633 100644
--- a/content/github/site-policy/github-sponsors-additional-terms.md
+++ b/content/github/site-policy/github-sponsors-additional-terms.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-sponsors-additional-terms
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Your participation in the GitHub Sponsors Program (the "Program") is subject to the [GitHub Terms of Service](/github/site-policy/github-terms-of-service) (the "Agreement"), as well as the following additional terms ("Additional Terms"). Any use of the GitHub Sponsors Program that violates the Agreement will also be a violation of these Additional Terms. Any capitalized terms used but not defined below have the meanings in the Agreement. These Additional Terms for the GitHub Sponsors Program describe the relationship between GitHub and you, the "Sponsored Developer", for the Program. The Additional Terms are effective as of the date you accept them ("Effective Date").
@@ -118,7 +121,7 @@ During the term, GitHub will remit to you all Sponsored Developer Payments recei
- For newly created Sponsored Developer Accounts, GitHub will remit to you all Sponsored Developer Payments received in a given month within 90 days of the creation of your Sponsored Developer Account, subject to the variables below. Payments thereafter will be remitted within 30 days of the close of that month, in accordance with this section.
-- If you are paid through Stripe Connect, you will receive payouts on the 22nd of the month for your balance at the end of the previous month, regardless of the amount of the balance.
+- If you are paid through Stripe Connect, you will receive payouts on the 22nd of the month for the balance accrued since the last payout, regardless of the amount of the balance. Payout initiation dates vary by country, and can change from month to month due to public holidays, weekends, and other factors.
- If you are paid through ACH transfer or wire transfer, you will receive payouts on the third Thursday of the month. GitHub will issue a payout to you for any month that your balance reaches $100 USD. Contributions from the GitHub Sponsors Matching Fund do not count towards this threshold. If your balance is below $100 at the end of the month, the balance will accrue until the next time your balance is above the threshold at the end of the month. If you leave GitHub Sponsors, GitHub will issue a payout for your remaining balance even if the balance is below $100.
diff --git a/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md b/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md
index 8d41be2fb7..9ca2aa38b1 100644
--- a/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md
+++ b/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-statement-against-modern-slavery-and-child-labor
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
*2018 statement*
diff --git a/content/github/site-policy/github-subprocessors-and-cookies.md b/content/github/site-policy/github-subprocessors-and-cookies.md
index 345953c1b9..c36e6115d1 100644
--- a/content/github/site-policy/github-subprocessors-and-cookies.md
+++ b/content/github/site-policy/github-subprocessors-and-cookies.md
@@ -8,6 +8,9 @@ redirect_from:
- /articles/github-subprocessors-and-cookies
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Effective date: **January 29, 2021**
diff --git a/content/github/site-policy/github-terms-of-service.md b/content/github/site-policy/github-terms-of-service.md
index 183df800d6..77d9fc4fb5 100644
--- a/content/github/site-policy/github-terms-of-service.md
+++ b/content/github/site-policy/github-terms-of-service.md
@@ -8,6 +8,9 @@ redirect_from:
- /articles/github-terms-of-service
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Thank you for using GitHub! We're happy you're here. Please read this Terms of Service agreement carefully before accessing or using GitHub. Because it is such an important contract between us and our users, we have tried to make it as clear as possible. For your convenience, we have presented these terms in a short non-binding summary followed by the full legal terms.
diff --git a/content/github/site-policy/github-trademark-policy.md b/content/github/site-policy/github-trademark-policy.md
index e2dd80c88a..c1f4986beb 100644
--- a/content/github/site-policy/github-trademark-policy.md
+++ b/content/github/site-policy/github-trademark-policy.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github-trademark-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### What is a GitHub Trademark Policy Violation?
diff --git a/content/github/site-policy/github-username-policy.md b/content/github/site-policy/github-username-policy.md
index 532399005d..89ef4713f9 100644
--- a/content/github/site-policy/github-username-policy.md
+++ b/content/github/site-policy/github-username-policy.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/github-username-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
GitHub account names are available on a first-come, first-served basis, and are intended for immediate and active use.
diff --git a/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md b/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md
index 0fa984fdf7..4506d018c8 100644
--- a/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md
+++ b/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md
@@ -2,6 +2,9 @@
title: GitHub's Notice about the California Consumer Privacy Act
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Effective January 1, 2020
diff --git a/content/github/site-policy/global-privacy-practices.md b/content/github/site-policy/global-privacy-practices.md
index 492baa42d6..a9a8e8c8ec 100644
--- a/content/github/site-policy/global-privacy-practices.md
+++ b/content/github/site-policy/global-privacy-practices.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/global-privacy-practices
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Effective date: July 22, 2020
diff --git a/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md b/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md
index 67029fd81e..ec9f4459ed 100644
--- a/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md
+++ b/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/guide-to-submitting-a-dmca-counter-notice
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
This guide describes the information that GitHub needs in order to process a counter notice to a DMCA takedown request. If you have more general questions about what the DMCA is or how GitHub processes DMCA takedown requests, please review our [DMCA Takedown Policy](/articles/dmca-takedown-policy).
diff --git a/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md b/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md
index 78989d6112..63df89aedf 100644
--- a/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md
+++ b/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md
@@ -6,6 +6,9 @@ redirect_from:
- /articles/guide-to-submitting-a-dmca-takedown-notice
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
This guide describes the information that GitHub needs in order to process a DMCA takedown request. If you have more general questions about what the DMCA is or how GitHub processes DMCA takedown requests, please review our [DMCA Takedown Policy](/articles/dmca-takedown-policy).
diff --git a/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md
index f045697c83..d5639fc952 100644
--- a/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md
+++ b/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/guidelines-for-legal-requests-of-user-data
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
Are you a law enforcement officer conducting an investigation that may involve user content hosted on GitHub?
diff --git a/content/github/site-policy/index.md b/content/github/site-policy/index.md
index c2cef76160..9d4e8b3ef8 100644
--- a/content/github/site-policy/index.md
+++ b/content/github/site-policy/index.md
@@ -5,6 +5,9 @@ redirect_from:
- /categories/site-policy
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
diff --git a/content/github/site-policy/responsible-disclosure-of-security-vulnerabilities.md b/content/github/site-policy/responsible-disclosure-of-security-vulnerabilities.md
index 34dd98fa5d..35a5ae50cf 100644
--- a/content/github/site-policy/responsible-disclosure-of-security-vulnerabilities.md
+++ b/content/github/site-policy/responsible-disclosure-of-security-vulnerabilities.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/responsible-disclosure-of-security-vulnerabilities
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
We want to keep GitHub safe for everyone. If you've discovered a security vulnerability in GitHub, we appreciate your help in disclosing it to us in a responsible manner.
diff --git a/content/github/site-policy/submitting-content-removal-requests.md b/content/github/site-policy/submitting-content-removal-requests.md
index d856dd5a12..88c636f344 100644
--- a/content/github/site-policy/submitting-content-removal-requests.md
+++ b/content/github/site-policy/submitting-content-removal-requests.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/submitting-content-removal-requests
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
We understand that copyrighted, trademarked, or private content may get published on GitHub – either accidentally or on purpose – sometimes in repositories that you do not own. Because the nature of this content varies, and because of different applicable laws, each category has its own, distinct reporting requirements outlined in our policies.
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md
index 003da8a970..567107b3e5 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-sponsored-developers
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md
index b3bb5af8c9..0169550a2d 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-github-sponsors
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About {% data variables.product.prodname_sponsors %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md b/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md
index 993701f37c..f85f61fdfc 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md
@@ -1,9 +1,11 @@
---
title: Attributing sponsorships to your organization
-intro: 'You can attribute the sponsorships paid by one of your organizations to another organization.'
+intro: You can attribute the sponsorships paid by one of your organizations to another organization.
versions:
free-pro-team: '*'
permissions: People who are organization owners of both organizations can attribute one organization's sponsorships to another organization.
+topics:
+ - sponsors
---
1. Navigate to the organization whose sponsorships you want to attribute to another organization.
@@ -14,4 +16,4 @@ permissions: People who are organization owners of both organizations can attrib
1. Under "Link sponsorships to another account", use the drop-down menu, then click the organization you want this organization's sponsorships to be attributed to.
1. Click **Link account**.
- 
\ No newline at end of file
+ 
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md b/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md
index f9b176f55d..f6d6dc0bd7 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/changing-your-sponsorship-tiers
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About sponsorship tiers
@@ -29,4 +31,4 @@ versions:
{% data reusables.sponsors.edit-tier %}
{% data reusables.sponsors.tier-price-description %}
{% data reusables.sponsors.tier-update %}
-{% data reusables.sponsors.retire-tier %}
\ No newline at end of file
+{% data reusables.sponsors.retire-tier %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md b/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
index 0cae836a8f..861e9dd6de 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
@@ -3,6 +3,8 @@ title: Configuring webhooks for events in your sponsored account
intro: You can configure webhooks to alert you when you receive new sponsorships or existing sponsors make changes to their sponsorships.
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About webhooks for events in your sponsored account
@@ -19,4 +21,4 @@ To monitor changes to your sponsorships, such as cancellations at the end of a p
{% data reusables.sponsors.webhook-secret-token %}
{% data reusables.sponsors.add-active-triggers %}
{% data reusables.sponsors.confirm-add-webhook %}
-{% data reusables.sponsors.manage-existing-webhooks %}
\ No newline at end of file
+{% data reusables.sponsors.manage-existing-webhooks %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md
index 640d965448..5b8efe069c 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/contacting-your-sponsors
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About sponsorship updates
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md
index 53004b7463..83b5544581 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/editing-your-sponsored-developer-profile
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About sponsor profiles
@@ -23,4 +25,4 @@ Your {% data variables.product.prodname_sponsors %} profile tells potential spon
{% data reusables.sponsors.add-introduction %}
{% data reusables.sponsors.edit-featured-work %}
{% data reusables.sponsors.opt-in-to-being-featured %}
-{% data reusables.sponsors.save-profile %}
\ No newline at end of file
+{% data reusables.sponsors.save-profile %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/index.md b/content/github/supporting-the-open-source-community-with-github-sponsors/index.md
index 48892ef8f2..6623eceb6b 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/index.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/index.md
@@ -6,6 +6,8 @@ redirect_from:
- /categories/supporting-the-open-source-community-with-github-sponsors
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md
index abfed9bd2c..caa1572855 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/managing-your-payouts-from-github-sponsors
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About payouts from {% data variables.product.prodname_sponsors %}
@@ -17,4 +19,4 @@ You can only manage your payouts from {% data variables.product.prodname_sponsor
{% data reusables.sponsors.navigate-to-sponsors-dashboard %}
{% data reusables.sponsors.navigate-to-payouts-tab %}
-{% data reusables.sponsors.edit-bank-information %}
\ No newline at end of file
+{% data reusables.sponsors.edit-bank-information %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md
index a4d3bdc206..1d9a6e18e3 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md
@@ -3,6 +3,8 @@ title: Managing your sponsorship goal
intro: You can set a goal for your sponsored developer or sponsored organization account to help the community understand the impact of sponsoring you.
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About sponsorship goals
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md
index ad0e8d461d..2088f90c19 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/managing-your-sponsorship
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
{% data reusables.sponsors.org-sponsors-release-phase %}
@@ -32,4 +34,4 @@ You can choose whether an account you sponsor can send you email updates about t
### Further reading
- "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)"
-- "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)"
\ No newline at end of file
+- "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)"
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/overview.md b/content/github/supporting-the-open-source-community-with-github-sponsors/overview.md
index f5271481a4..b068234cb2 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/overview.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/overview.md
@@ -4,5 +4,7 @@ intro: 'Learn about {% data variables.product.prodname_sponsors %} and how you c
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md
index 02aec92e58..fb2a1f92f9 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md
@@ -8,5 +8,7 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-as-a-sponsored-developer
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md
index 3d15b43662..5a7e674121 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md
@@ -7,6 +7,8 @@ redirect_from:
permissions: 'Organization owners can set up {% data variables.product.prodname_sponsors %} for an organization.'
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md
index 5b14699adc..6104ee4c03 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/becoming-a-sponsored-developer
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md b/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md
index c51237a55c..c09ee905fb 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
free-pro-team: '*'
permissions: Anyone can sponsor accounts on behalf of their own user account. Organization owners and billing managers can sponsor accounts on behalf of their organization.
+topics:
+ - sponsors
---
{% data reusables.sponsors.org-sponsors-release-phase %}
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors.md
index dd52943a77..afbdabd06a 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors.md
@@ -7,5 +7,7 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-developers
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md b/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md
index 2f881fc29a..82ebe0fca0 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md
@@ -6,6 +6,8 @@ redirect_from:
- /github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-sponsored-developers
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
If you are a taxpayer in the United States, you must submit a W-9 before you can receive payments. If you are a taxpayer in any other region besides the United States, you must submit a W-8BEN before you can receive payments. For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account#submitting-your-tax-information)" and "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization#submitting-your-tax-information)." {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms.
diff --git a/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md b/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md
index 20cf721790..79bd24bdcc 100644
--- a/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md
+++ b/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/viewing-your-sponsors-and-sponsorships
versions:
free-pro-team: '*'
+topics:
+ - sponsors
---
### About sponsors and sponsorships
@@ -31,4 +33,4 @@ You can export your sponsorship transactions by month. {% data variables.product
1. Click {% octicon "download" aria-label="The download icon" %} **Export**.
1. Choose a time frame and a format for the data you'd like to export, then click **Start export**.
- 
\ No newline at end of file
+ 
diff --git a/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md b/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md
index 6f402fa285..d8c5ccd8f1 100644
--- a/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md
+++ b/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md
@@ -6,6 +6,9 @@ redirect_from:
intro: '{% data variables.product.product_name %} uses your repository''s data to connect you to relevant tools, people, projects, and information.'
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### About {% data variables.product.product_name %}'s use of your data
diff --git a/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md
index 91c7975d75..0c50b67417 100644
--- a/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md
+++ b/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md
@@ -6,6 +6,9 @@ redirect_from:
- /github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### About data use for your private repository
diff --git a/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md
index 33b5ccc121..15b3026ba4 100644
--- a/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md
+++ b/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md
@@ -4,6 +4,9 @@ intro: 'You can manage whether {% data variables.product.prodname_dotcom %} incl
permissions: 'People with admin permissions to a public repository can opt into or out of the {% data variables.product.prodname_archive %}.'
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
{% data reusables.repositories.about-github-archive-program %} For more information, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)."
diff --git a/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md b/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md
index a04e115614..cbbff257f7 100644
--- a/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md
+++ b/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md
@@ -6,6 +6,9 @@ redirect_from:
intro: '{% data reusables.user_settings.export-data %}'
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
{% data variables.product.product_name %} stores repository and profile metadata from your personal account's activity. You can export your personal account's data through settings on {% data variables.product.prodname_dotcom_the_website %} or with the User Migration API.
diff --git a/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md b/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md
index 10a714d35b..d4ccc71ae2 100644
--- a/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md
+++ b/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
A repository's graphs give you information on {% if currentVersion == "free-pro-team@latest" %} traffic, projects that depend on the repository,{% endif %} contributors and commits to the repository, and a repository's forks and network. If you maintain a repository, you can use this data to get a better understanding of who's using your repository and why they're using it.
diff --git a/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
index c366f251c9..626cd9509e 100644
--- a/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
+++ b/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
@@ -4,6 +4,8 @@ intro: 'Detailed information about the dependency graph, the ecosystems it suppo
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - repositories
---
### Dependency graph availability
diff --git a/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md b/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md
index bf325418e0..b5f1e57168 100644
--- a/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md
+++ b/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md b/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md
index 1bcc381a77..46548cb73a 100644
--- a/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md
+++ b/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md
@@ -10,5 +10,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md
index c78fdbcd3f..8dad33dd99 100644
--- a/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md
+++ b/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md
@@ -10,6 +10,8 @@ redirect_from:
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - repositories
---
### Viewing the dependency graph
diff --git a/content/github/visualizing-repository-data-with-graphs/index.md b/content/github/visualizing-repository-data-with-graphs/index.md
index bbe4472b6b..a993301675 100644
--- a/content/github/visualizing-repository-data-with-graphs/index.md
+++ b/content/github/visualizing-repository-data-with-graphs/index.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md b/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md
index efe4b1170c..0a0cc5f54e 100644
--- a/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md
+++ b/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Forks are listed alphabetically by the username of the person who forked the repository. You can click on the username to be redirected to the user's {% data variables.product.product_name %} profile page or click on the fork name to be redirected to the specific fork of the repository.
diff --git a/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md b/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md
index 3159e6eab6..4ebccd26f2 100644
--- a/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md
+++ b/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md
@@ -8,5 +8,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md b/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md
index 2b091f4867..62b061ec2a 100644
--- a/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md
+++ b/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
### About contributors
diff --git a/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md b/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md
index 9227b4a81d..12a6d53185 100644
--- a/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md
+++ b/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
diff --git a/content/github/visualizing-repository-data-with-graphs/viewing-a-summary-of-repository-activity.md b/content/github/visualizing-repository-data-with-graphs/viewing-a-summary-of-repository-activity.md
index e9bfbbaf20..a5e0b26677 100644
--- a/content/github/visualizing-repository-data-with-graphs/viewing-a-summary-of-repository-activity.md
+++ b/content/github/visualizing-repository-data-with-graphs/viewing-a-summary-of-repository-activity.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
Commit co-authors are included in the commit activity summary if their commits were merged into the repository's default branch and they're in the top 15 users who have contributed the most commits.
diff --git a/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
index 5597ba9682..022031753d 100644
--- a/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
+++ b/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/viewing-traffic-to-a-repository
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic.
diff --git a/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md b/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md
index 547d43123b..36db23194d 100644
--- a/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md
+++ b/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
{% if currentVersion == "free-pro-team@latest" %}
diff --git a/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md b/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md
index 512af56ba8..1085f95882 100644
--- a/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md
+++ b/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - repositories
---
The top graph shows commits for the entire year by week.
diff --git a/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md b/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md
index 6e91515f92..e4df3a2b7f 100644
--- a/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md
+++ b/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md
@@ -9,6 +9,8 @@ redirect_from:
product: '{% data reusables.gated-features.pages %}'
versions:
free-pro-team: '*'
+topics:
+ - pages
---
### Supported custom domains
diff --git a/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/content/github/working-with-github-pages/about-github-pages-and-jekyll.md
index f846f7c244..29cb2ecc6a 100644
--- a/content/github/working-with-github-pages/about-github-pages-and-jekyll.md
+++ b/content/github/working-with-github-pages/about-github-pages-and-jekyll.md
@@ -22,6 +22,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
### About Jekyll
diff --git a/content/github/working-with-github-pages/about-github-pages.md b/content/github/working-with-github-pages/about-github-pages.md
index 71923497cc..fc1ad704c5 100644
--- a/content/github/working-with-github-pages/about-github-pages.md
+++ b/content/github/working-with-github-pages/about-github-pages.md
@@ -14,6 +14,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
### About {% data variables.product.prodname_pages %}
diff --git a/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md
index d472ee4b10..aaac77ac7d 100644
--- a/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md
+++ b/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
### About Jekyll build errors
diff --git a/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md
index 8d27177055..99062c6ee8 100644
--- a/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md
+++ b/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
People with write permissions for a repository can add a theme to a {% data variables.product.prodname_pages %} site using Jekyll.
diff --git a/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md b/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md
index 54505770e5..c7ffa5b088 100644
--- a/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md
+++ b/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md
@@ -8,6 +8,8 @@ redirect_from:
product: '{% data reusables.gated-features.pages %}'
versions:
free-pro-team: '*'
+topics:
+ - pages
---
People with admin permissions for a repository can use the theme chooser to add a theme to a {% data variables.product.prodname_pages %} site.
diff --git a/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md b/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md
index 26e7f87d19..bf7966fab7 100644
--- a/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md
+++ b/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
People with write permissions for a repository can add content to a {% data variables.product.prodname_pages %} site using Jekyll.
diff --git a/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md b/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md
index b61565f5a4..59a714c5d8 100644
--- a/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md
+++ b/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md
@@ -14,5 +14,7 @@ product: '{% data reusables.gated-features.pages %}'
mapTopic: true
versions:
free-pro-team: '*'
+topics:
+ - pages
---
diff --git a/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md
index 03b0b70f08..34fa16eaba 100644
--- a/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md
+++ b/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
For more information about publishing sources, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
diff --git a/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md b/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md
index e64b467d98..b4d87e69b1 100644
--- a/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md
+++ b/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
{% data reusables.pages.navigate-site-repo %}
diff --git a/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
index a6857aa6ed..bf7f5f5cb1 100644
--- a/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
+++ b/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
{% data reusables.pages.org-owners-can-restrict-pages-creation %}
diff --git a/content/github/working-with-github-pages/creating-a-github-pages-site.md b/content/github/working-with-github-pages/creating-a-github-pages-site.md
index d8d0f6a57d..07106d9952 100644
--- a/content/github/working-with-github-pages/creating-a-github-pages-site.md
+++ b/content/github/working-with-github-pages/creating-a-github-pages-site.md
@@ -12,6 +12,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
{% data reusables.pages.org-owners-can-restrict-pages-creation %}
diff --git a/content/github/working-with-github-pages/getting-started-with-github-pages.md b/content/github/working-with-github-pages/getting-started-with-github-pages.md
index 2c570f5de4..12d5e61d51 100644
--- a/content/github/working-with-github-pages/getting-started-with-github-pages.md
+++ b/content/github/working-with-github-pages/getting-started-with-github-pages.md
@@ -11,5 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
diff --git a/content/github/working-with-github-pages/index.md b/content/github/working-with-github-pages/index.md
index 23e60f9646..3580a1e6b2 100644
--- a/content/github/working-with-github-pages/index.md
+++ b/content/github/working-with-github-pages/index.md
@@ -15,6 +15,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
diff --git a/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md
index 52661f89b4..da288d5eab 100644
--- a/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md
+++ b/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md
@@ -13,6 +13,8 @@ redirect_from:
product: '{% data reusables.gated-features.pages %}'
versions:
free-pro-team: '*'
+topics:
+ - pages
---
People with admin permissions for a repository can configure a custom domain for a {% data variables.product.prodname_pages %} site.
diff --git a/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md b/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md
index 5b4d1ccac3..8fde3a5ee5 100644
--- a/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md
+++ b/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/securing-your-github-pages-site-with-https
versions:
free-pro-team: '*'
+topics:
+ - pages
---
People with admin permissions for a repository can enforce HTTPS for a {% data variables.product.prodname_pages %} site.
diff --git a/content/github/working-with-github-pages/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md b/content/github/working-with-github-pages/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md
index 93c5e1e0d6..aec7dde42f 100644
--- a/content/github/working-with-github-pages/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md
+++ b/content/github/working-with-github-pages/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
People with write permissions for a repository can set the Markdown processor for a {% data variables.product.prodname_pages %} site.
diff --git a/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md b/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md
index b1ec8358fd..6f204fdb8a 100644
--- a/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md
+++ b/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md
@@ -11,5 +11,7 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
diff --git a/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md b/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md
index 283cb86b68..d24b5f19f7 100644
--- a/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md
+++ b/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md
@@ -10,6 +10,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
Anyone with read permissions for a repository can test a {% data variables.product.prodname_pages %} site locally.
diff --git a/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md
index 132048eabb..1c6c9279c0 100644
--- a/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md
+++ b/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md
@@ -9,6 +9,8 @@ redirect_from:
product: '{% data reusables.gated-features.pages %}'
versions:
free-pro-team: '*'
+topics:
+ - pages
---
### _CNAME_ errors
diff --git a/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md
index 22f7e9a648..9d5eb1717f 100644
--- a/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md
+++ b/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md
@@ -29,6 +29,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
### Troubleshooting build errors
diff --git a/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md
index 7fbd610e00..912cc52b6f 100644
--- a/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md
+++ b/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md
@@ -13,6 +13,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - pages
---
### Unpublishing a project site
diff --git a/content/github/working-with-github-pages/using-submodules-with-github-pages.md b/content/github/working-with-github-pages/using-submodules-with-github-pages.md
index f3dd9add82..a68562a1ce 100644
--- a/content/github/working-with-github-pages/using-submodules-with-github-pages.md
+++ b/content/github/working-with-github-pages/using-submodules-with-github-pages.md
@@ -7,6 +7,8 @@ redirect_from:
product: '{% data reusables.gated-features.pages %}'
versions:
free-pro-team: '*'
+topics:
+ - pages
---
If the repository for your {% data variables.product.prodname_pages %} site contains submodules, their contents will automatically be pulled in when your site is built.
diff --git a/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md b/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md
index 37248a0158..82c8aa865b 100644
--- a/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md
+++ b/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md
@@ -6,6 +6,8 @@ redirect_from:
- /articles/about-github-premium-support-for-github-enterprise-cloud
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
{% note %}
diff --git a/content/github/working-with-github-support/about-github-support.md b/content/github/working-with-github-support/about-github-support.md
index d99fa74258..88a7af7ff5 100644
--- a/content/github/working-with-github-support/about-github-support.md
+++ b/content/github/working-with-github-support/about-github-support.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/about-github-support
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
### About {% data variables.contact.github_support %}
diff --git a/content/github/working-with-github-support/github-enterprise-cloud-support.md b/content/github/working-with-github-support/github-enterprise-cloud-support.md
index 2fbdf674e3..412a41aeca 100644
--- a/content/github/working-with-github-support/github-enterprise-cloud-support.md
+++ b/content/github/working-with-github-support/github-enterprise-cloud-support.md
@@ -7,6 +7,8 @@ redirect_from:
intro: '{% data variables.product.prodname_ghe_cloud %} includes a target eight-hour response time for priority support requests, Monday to Friday in your local time zone.'
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
{% note %}
diff --git a/content/github/working-with-github-support/github-marketplace-support.md b/content/github/working-with-github-support/github-marketplace-support.md
index cfa20c4dc6..b548f03fcc 100644
--- a/content/github/working-with-github-support/github-marketplace-support.md
+++ b/content/github/working-with-github-support/github-marketplace-support.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/github-marketplace-support
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
diff --git a/content/github/working-with-github-support/index.md b/content/github/working-with-github-support/index.md
index 1ea83fac6b..5e266237af 100644
--- a/content/github/working-with-github-support/index.md
+++ b/content/github/working-with-github-support/index.md
@@ -5,6 +5,8 @@ redirect_from:
- /forum
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
diff --git a/content/github/working-with-github-support/submitting-a-ticket.md b/content/github/working-with-github-support/submitting-a-ticket.md
index f3fa8d8493..616b7929fd 100644
--- a/content/github/working-with-github-support/submitting-a-ticket.md
+++ b/content/github/working-with-github-support/submitting-a-ticket.md
@@ -5,6 +5,8 @@ redirect_from:
- /articles/submitting-a-ticket
versions:
free-pro-team: '*'
+topics:
+ - jobs
---
If your account uses a paid {% data variables.product.prodname_dotcom %} product, you can directly contact {% data variables.contact.github_support %}. If your account uses {% data variables.product.prodname_free_user %} for user accounts and organizations, you can contact {% data variables.contact.contact_support %} to report account, security, and abuse issues. For more information, see "[About GitHub Support](/github/working-with-github-support/about-github-support)."
diff --git a/content/graphql/guides/forming-calls-with-graphql.md b/content/graphql/guides/forming-calls-with-graphql.md
index 6824e71293..aebd9103f9 100644
--- a/content/graphql/guides/forming-calls-with-graphql.md
+++ b/content/graphql/guides/forming-calls-with-graphql.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Authenticating with GraphQL
diff --git a/content/graphql/guides/index.md b/content/graphql/guides/index.md
index 35387642ba..ca2df6f367 100644
--- a/content/graphql/guides/index.md
+++ b/content/graphql/guides/index.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% link_in_list /introduction-to-graphql %}
diff --git a/content/graphql/guides/introduction-to-graphql.md b/content/graphql/guides/introduction-to-graphql.md
index 542305f7ca..7c4720043c 100644
--- a/content/graphql/guides/introduction-to-graphql.md
+++ b/content/graphql/guides/introduction-to-graphql.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### GraphQL terminology
diff --git a/content/graphql/guides/managing-enterprise-accounts.md b/content/graphql/guides/managing-enterprise-accounts.md
index 4f61114914..acb2035bf1 100644
--- a/content/graphql/guides/managing-enterprise-accounts.md
+++ b/content/graphql/guides/managing-enterprise-accounts.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About managing enterprise accounts with GraphQL
diff --git a/content/graphql/guides/migrating-from-rest-to-graphql.md b/content/graphql/guides/migrating-from-rest-to-graphql.md
index 27493df1c5..f51a5ec5e3 100644
--- a/content/graphql/guides/migrating-from-rest-to-graphql.md
+++ b/content/graphql/guides/migrating-from-rest-to-graphql.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Differences in API logic
diff --git a/content/graphql/guides/using-global-node-ids.md b/content/graphql/guides/using-global-node-ids.md
index 0fb33e4920..80ef4ebd38 100644
--- a/content/graphql/guides/using-global-node-ids.md
+++ b/content/graphql/guides/using-global-node-ids.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
You can access most objects in GitHub (users, issues, pull requests, etc.) using either the REST API or the GraphQL API. With a [recent update](https://developer.github.com/changes/2017-12-19-graphql-node-id/), you can find the **global node ID** of many objects from within the REST API and use these IDs in your GraphQL operations.
diff --git a/content/graphql/guides/using-the-explorer.md b/content/graphql/guides/using-the-explorer.md
index b0ebb7c5bc..705a2c3416 100644
--- a/content/graphql/guides/using-the-explorer.md
+++ b/content/graphql/guides/using-the-explorer.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
## About the GraphQL Explorer
diff --git a/content/graphql/overview/about-the-graphql-api.md b/content/graphql/overview/about-the-graphql-api.md
index 0c7b36f81b..cb5eab5f5b 100644
--- a/content/graphql/overview/about-the-graphql-api.md
+++ b/content/graphql/overview/about-the-graphql-api.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Overview
diff --git a/content/graphql/overview/breaking-changes.md b/content/graphql/overview/breaking-changes.md
index ba29ae3c09..6cdf450bef 100644
--- a/content/graphql/overview/breaking-changes.md
+++ b/content/graphql/overview/breaking-changes.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About breaking changes
diff --git a/content/graphql/overview/changelog.md b/content/graphql/overview/changelog.md
index 6c051b659f..3ecd22c955 100644
--- a/content/graphql/overview/changelog.md
+++ b/content/graphql/overview/changelog.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
Breaking changes include changes that will break existing queries or could affect the runtime behavior of clients. For a list of breaking changes and when they will occur, see our [breaking changes log](/graphql/overview/breaking-changes).
diff --git a/content/graphql/overview/explorer.md b/content/graphql/overview/explorer.md
index 74540b78a4..b4d07c0939 100644
--- a/content/graphql/overview/explorer.md
+++ b/content/graphql/overview/explorer.md
@@ -8,5 +8,7 @@ versions:
enterprise-server: '*'
github-ae: '*'
layout: graphql-explorer
+topics:
+ - api
---
diff --git a/content/graphql/overview/public-schema.md b/content/graphql/overview/public-schema.md
index d2a8c7309b..81dceae4a8 100644
--- a/content/graphql/overview/public-schema.md
+++ b/content/graphql/overview/public-schema.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
You can [perform introspection](/graphql/guides/introduction-to-graphql#discovering-the-graphql-api) against the GraphQL API directly.
diff --git a/content/graphql/overview/resource-limitations.md b/content/graphql/overview/resource-limitations.md
index 636fee5b9c..4ca5ba3f63 100644
--- a/content/graphql/overview/resource-limitations.md
+++ b/content/graphql/overview/resource-limitations.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
## Node limit
diff --git a/content/graphql/overview/schema-previews.md b/content/graphql/overview/schema-previews.md
index 6272f17066..d653fad776 100644
--- a/content/graphql/overview/schema-previews.md
+++ b/content/graphql/overview/schema-previews.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About schema previews
diff --git a/content/graphql/reference/enums.md b/content/graphql/reference/enums.md
index 50ff25548c..108b9b8be4 100644
--- a/content/graphql/reference/enums.md
+++ b/content/graphql/reference/enums.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About enums
diff --git a/content/graphql/reference/input-objects.md b/content/graphql/reference/input-objects.md
index ad927ff2bb..35065838c7 100644
--- a/content/graphql/reference/input-objects.md
+++ b/content/graphql/reference/input-objects.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About input objects
diff --git a/content/graphql/reference/interfaces.md b/content/graphql/reference/interfaces.md
index 492e7b535c..175ff95b3d 100644
--- a/content/graphql/reference/interfaces.md
+++ b/content/graphql/reference/interfaces.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About interfaces
diff --git a/content/graphql/reference/mutations.md b/content/graphql/reference/mutations.md
index 387dcd51ac..f523fd3168 100644
--- a/content/graphql/reference/mutations.md
+++ b/content/graphql/reference/mutations.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About mutations
diff --git a/content/graphql/reference/objects.md b/content/graphql/reference/objects.md
index 7872b01baa..c99b46cca6 100644
--- a/content/graphql/reference/objects.md
+++ b/content/graphql/reference/objects.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About objects
diff --git a/content/graphql/reference/queries.md b/content/graphql/reference/queries.md
index 48b714cd4b..208f468589 100644
--- a/content/graphql/reference/queries.md
+++ b/content/graphql/reference/queries.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About queries
diff --git a/content/graphql/reference/scalars.md b/content/graphql/reference/scalars.md
index 2863a61f0d..8df4267a78 100644
--- a/content/graphql/reference/scalars.md
+++ b/content/graphql/reference/scalars.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About scalars
diff --git a/content/graphql/reference/unions.md b/content/graphql/reference/unions.md
index 2c9b6a7862..9b7381ec3f 100644
--- a/content/graphql/reference/unions.md
+++ b/content/graphql/reference/unions.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About unions
diff --git a/content/packages/learn-github-packages/about-github-packages.md b/content/packages/learn-github-packages/about-github-packages.md
index b9b21493b8..3aa637f5d7 100644
--- a/content/packages/learn-github-packages/about-github-packages.md
+++ b/content/packages/learn-github-packages/about-github-packages.md
@@ -24,20 +24,13 @@ You can integrate {% data variables.product.prodname_registry %} with {% data va
{% data variables.product.prodname_registry %} offers different package registries for commonly used packages, such as for Node, RubyGems, Apache Maven, Gradle, and Nuget.
-
-{% if currentVersion ver_gt "enterprise-server@2.21" %}
-
-
-
-{% endif %}
+
{% if currentVersion == "free-pro-team@latest" %}
{% data variables.product.prodname_registry %} also offers a {% data variables.product.prodname_container_registry %} designed to support the unique needs of container images. For more information, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/guides/about-github-container-registry)."
{% data reusables.package_registry.container-registry-beta %}
-
-
{% endif %}
#### Viewing packages
diff --git a/content/rest/guides/basics-of-authentication.md b/content/rest/guides/basics-of-authentication.md
index 1cbc4cdb95..5613158c98 100644
--- a/content/rest/guides/basics-of-authentication.md
+++ b/content/rest/guides/basics-of-authentication.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/best-practices-for-integrators.md b/content/rest/guides/best-practices-for-integrators.md
index c9bed981f3..fc3a313eb2 100644
--- a/content/rest/guides/best-practices-for-integrators.md
+++ b/content/rest/guides/best-practices-for-integrators.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/building-a-ci-server.md b/content/rest/guides/building-a-ci-server.md
index a084419a96..77b0d89956 100644
--- a/content/rest/guides/building-a-ci-server.md
+++ b/content/rest/guides/building-a-ci-server.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/delivering-deployments.md b/content/rest/guides/delivering-deployments.md
index b9ef899783..b5340295e8 100644
--- a/content/rest/guides/delivering-deployments.md
+++ b/content/rest/guides/delivering-deployments.md
@@ -9,6 +9,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/discovering-resources-for-a-user.md b/content/rest/guides/discovering-resources-for-a-user.md
index 51dde97000..1c6177f34e 100644
--- a/content/rest/guides/discovering-resources-for-a-user.md
+++ b/content/rest/guides/discovering-resources-for-a-user.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/getting-started-with-the-checks-api.md b/content/rest/guides/getting-started-with-the-checks-api.md
index e83f7ecde7..66e353a328 100644
--- a/content/rest/guides/getting-started-with-the-checks-api.md
+++ b/content/rest/guides/getting-started-with-the-checks-api.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Overview
diff --git a/content/rest/guides/getting-started-with-the-git-database-api.md b/content/rest/guides/getting-started-with-the-git-database-api.md
index f95f46749d..7ce9354f48 100644
--- a/content/rest/guides/getting-started-with-the-git-database-api.md
+++ b/content/rest/guides/getting-started-with-the-git-database-api.md
@@ -5,6 +5,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Overview
diff --git a/content/rest/guides/getting-started-with-the-rest-api.md b/content/rest/guides/getting-started-with-the-rest-api.md
index 1313385db7..2e5a47f87b 100644
--- a/content/rest/guides/getting-started-with-the-rest-api.md
+++ b/content/rest/guides/getting-started-with-the-rest-api.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/index.md b/content/rest/guides/index.md
index bbdd90cbcc..1e63a63190 100644
--- a/content/rest/guides/index.md
+++ b/content/rest/guides/index.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
This section of the documentation is intended to get you up-and-running with
diff --git a/content/rest/guides/rendering-data-as-graphs.md b/content/rest/guides/rendering-data-as-graphs.md
index 1fb621b0b7..cbd50a3e8f 100644
--- a/content/rest/guides/rendering-data-as-graphs.md
+++ b/content/rest/guides/rendering-data-as-graphs.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/traversing-with-pagination.md b/content/rest/guides/traversing-with-pagination.md
index 9ee0ffc050..50c89b4bdc 100644
--- a/content/rest/guides/traversing-with-pagination.md
+++ b/content/rest/guides/traversing-with-pagination.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/guides/working-with-comments.md b/content/rest/guides/working-with-comments.md
index 5b760d1877..5606e2030c 100644
--- a/content/rest/guides/working-with-comments.md
+++ b/content/rest/guides/working-with-comments.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/api-previews.md b/content/rest/overview/api-previews.md
index 40b18ca656..02151bb9fe 100644
--- a/content/rest/overview/api-previews.md
+++ b/content/rest/overview/api-previews.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/endpoints-available-for-github-apps.md b/content/rest/overview/endpoints-available-for-github-apps.md
index bae1b28804..8105ff975c 100644
--- a/content/rest/overview/endpoints-available-for-github-apps.md
+++ b/content/rest/overview/endpoints-available-for-github-apps.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)."
diff --git a/content/rest/overview/index.md b/content/rest/overview/index.md
index 7e4de671cb..287f95ae14 100644
--- a/content/rest/overview/index.md
+++ b/content/rest/overview/index.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Table of Contents
diff --git a/content/rest/overview/libraries.md b/content/rest/overview/libraries.md
index b1a38139dc..75cb6828c6 100644
--- a/content/rest/overview/libraries.md
+++ b/content/rest/overview/libraries.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/media-types.md b/content/rest/overview/media-types.md
index ccbfff6046..25ece0fa28 100644
--- a/content/rest/overview/media-types.md
+++ b/content/rest/overview/media-types.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/openapi-description.md b/content/rest/overview/openapi-description.md
index cdd2e1188e..9b38ae760b 100644
--- a/content/rest/overview/openapi-description.md
+++ b/content/rest/overview/openapi-description.md
@@ -1,9 +1,11 @@
---
title: OpenAPI description
-intro: The {% data variables.product.product_name %} REST API is fully described in an OpenAPI 3.0 compliant document.
+intro: 'The {% data variables.product.product_name %} REST API is fully described in an OpenAPI 3.0 compliant document.'
versions:
free-pro-team: '*'
enterprise-server: '*'
+topics:
+ - api
---
### About OpenAPI descriptions
diff --git a/content/rest/overview/other-authentication-methods.md b/content/rest/overview/other-authentication-methods.md
index e641de8216..8020cfd01a 100644
--- a/content/rest/overview/other-authentication-methods.md
+++ b/content/rest/overview/other-authentication-methods.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/resources-in-the-rest-api.md b/content/rest/overview/resources-in-the-rest-api.md
index 0d6c7fb29b..5344440e1d 100644
--- a/content/rest/overview/resources-in-the-rest-api.md
+++ b/content/rest/overview/resources-in-the-rest-api.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/overview/troubleshooting.md b/content/rest/overview/troubleshooting.md
index a430cfd7be..1b163b90f5 100644
--- a/content/rest/overview/troubleshooting.md
+++ b/content/rest/overview/troubleshooting.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
diff --git a/content/rest/reference/actions.md b/content/rest/reference/actions.md
index 5073629587..e8b3a61288 100644
--- a/content/rest/reference/actions.md
+++ b/content/rest/reference/actions.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - api
---
{% data reusables.actions.ae-beta %}
diff --git a/content/rest/reference/activity.md b/content/rest/reference/activity.md
index d80553b6c3..ac89e3da37 100644
--- a/content/rest/reference/activity.md
+++ b/content/rest/reference/activity.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% for operation in currentRestOperations %}
@@ -33,8 +35,6 @@ $ -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"'
> X-Poll-Interval: 60
```
-Events support pagination, however the `per_page` option is unsupported. The fixed page size is 30 items. Fetching up to ten pages is supported, for a total of 300 events. For information, see "[Traversing with pagination](/rest/guides/traversing-with-pagination)."
-
Only events created within the past 90 days will be included in timelines. Events older than 90 days will not be included (even if the total number of events in the timeline is less than 300).
{% for operation in currentRestOperations %}
diff --git a/content/rest/reference/apps.md b/content/rest/reference/apps.md
index bb5f310f7d..9238601e1a 100644
--- a/content/rest/reference/apps.md
+++ b/content/rest/reference/apps.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The GitHub Apps API enables you to get high-level information about a GitHub App as well as specific information about installations of the app. To learn more about GitHub Apps, see "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)."
diff --git a/content/rest/reference/billing.md b/content/rest/reference/billing.md
index e0ff6110c9..0fab2af1cd 100644
--- a/content/rest/reference/billing.md
+++ b/content/rest/reference/billing.md
@@ -2,6 +2,8 @@
title: Billing
versions:
free-pro-team: '*'
+topics:
+ - api
---
You can monitor your {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} charges and usage for a user and organization through the Billing API.
diff --git a/content/rest/reference/checks.md b/content/rest/reference/checks.md
index 67ba813b87..3b1a680aa1 100644
--- a/content/rest/reference/checks.md
+++ b/content/rest/reference/checks.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The Checks API enables you to build GitHub Apps that run powerful checks against code changes in a repository. You can create apps that perform continuous integration, code linting, or code scanning services and provide detailed feedback on commits. For more information, see "[Getting started with the checks API](/rest/guides/getting-started-with-the-checks-api)" and "[Creating CI tests with the Checks API](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)."
diff --git a/content/rest/reference/code-scanning.md b/content/rest/reference/code-scanning.md
index 68ae532ae5..535217ba8c 100644
--- a/content/rest/reference/code-scanning.md
+++ b/content/rest/reference/code-scanning.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '>=2.22'
github-ae: '*'
+topics:
+ - api
---
{% data reusables.code-scanning.beta %}
diff --git a/content/rest/reference/codes-of-conduct.md b/content/rest/reference/codes-of-conduct.md
index 50cb78757e..109bf9e922 100644
--- a/content/rest/reference/codes-of-conduct.md
+++ b/content/rest/reference/codes-of-conduct.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
You can use the Codes of Conduct API to retrieve information about a repository's code of conduct. To get a repository's code of conduct, use the "[Get a repository](/rest/reference/repos#get-a-repository)" endpoint.
diff --git a/content/rest/reference/emojis.md b/content/rest/reference/emojis.md
index ea2ca0751d..ec918c60c2 100644
--- a/content/rest/reference/emojis.md
+++ b/content/rest/reference/emojis.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% include rest_operations_at_current_path %}
diff --git a/content/rest/reference/enterprise-admin.md b/content/rest/reference/enterprise-admin.md
index f5005e0fa2..eca5f8f968 100644
--- a/content/rest/reference/enterprise-admin.md
+++ b/content/rest/reference/enterprise-admin.md
@@ -8,6 +8,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
You can use these endpoints to administer your enterprise.
diff --git a/content/rest/reference/gists.md b/content/rest/reference/gists.md
index 1ff371cc24..58d47faa72 100644
--- a/content/rest/reference/gists.md
+++ b/content/rest/reference/gists.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Authentication
diff --git a/content/rest/reference/git.md b/content/rest/reference/git.md
index b7f6a6ffaa..19e1c541ad 100644
--- a/content/rest/reference/git.md
+++ b/content/rest/reference/git.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The Git Database API gives you access to read and write raw Git objects to your Git database on {% data variables.product.product_name %} and to list and update your references (branch heads and tags). For more information about using the Git Database API, see "[Getting started with the Git data API](/rest/guides/getting-started-with-the-git-database-api)."
diff --git a/content/rest/reference/gitignore.md b/content/rest/reference/gitignore.md
index 21728e0dd3..08f18a2449 100644
--- a/content/rest/reference/gitignore.md
+++ b/content/rest/reference/gitignore.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
When you create a new {% data variables.product.product_name %} repository via the API, you can specify a [.gitignore template](/github/using-git/ignoring-files) to apply to the repository upon creation. The .gitignore templates API lists and fetches templates from the {% data variables.product.product_name %} [.gitignore repository](https://github.com/github/gitignore).
diff --git a/content/rest/reference/index.md b/content/rest/reference/index.md
index 3e0c064f4c..88efef37c8 100644
--- a/content/rest/reference/index.md
+++ b/content/rest/reference/index.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Table of Contents
diff --git a/content/rest/reference/interactions.md b/content/rest/reference/interactions.md
index 1fb73f9948..bce7ba6dff 100644
--- a/content/rest/reference/interactions.md
+++ b/content/rest/reference/interactions.md
@@ -4,6 +4,8 @@ redirect_from:
- /v3/interactions
versions:
free-pro-team: '*'
+topics:
+ - api
---
Users interact with repositories by commenting, opening issues, and creating pull requests. The Interactions APIs allow people with owner or admin access to temporarily restrict interaction with public repositories to a certain type of user.
diff --git a/content/rest/reference/issues.md b/content/rest/reference/issues.md
index d2bc96ed21..f69333fbc5 100644
--- a/content/rest/reference/issues.md
+++ b/content/rest/reference/issues.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Custom media types for issues
diff --git a/content/rest/reference/licenses.md b/content/rest/reference/licenses.md
index 080f5cba43..3a67c0b3c8 100644
--- a/content/rest/reference/licenses.md
+++ b/content/rest/reference/licenses.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The Licenses API returns metadata about popular open source licenses and information about a particular project's license file.
diff --git a/content/rest/reference/markdown.md b/content/rest/reference/markdown.md
index 5a71bd7804..e978876791 100644
--- a/content/rest/reference/markdown.md
+++ b/content/rest/reference/markdown.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% include rest_operations_at_current_path %}
diff --git a/content/rest/reference/meta.md b/content/rest/reference/meta.md
index b261f929a2..6cd6fa2083 100644
--- a/content/rest/reference/meta.md
+++ b/content/rest/reference/meta.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% include rest_operations_at_current_path %}
diff --git a/content/rest/reference/migrations.md b/content/rest/reference/migrations.md
index f1709a3c8f..c75353316f 100644
--- a/content/rest/reference/migrations.md
+++ b/content/rest/reference/migrations.md
@@ -6,6 +6,8 @@ redirect_from:
- /v3/migration/migrations
versions:
free-pro-team: '*'
+topics:
+ - api
---
{% for operation in currentRestOperations %}
diff --git a/content/rest/reference/orgs.md b/content/rest/reference/orgs.md
index 919098c451..45d9e1c36c 100644
--- a/content/rest/reference/orgs.md
+++ b/content/rest/reference/orgs.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% for operation in currentRestOperations %}
diff --git a/content/rest/reference/packages.md b/content/rest/reference/packages.md
index 53450d887c..36dc874017 100644
--- a/content/rest/reference/packages.md
+++ b/content/rest/reference/packages.md
@@ -3,6 +3,8 @@ title: Packages
product: '{% data reusables.gated-features.packages %}'
versions:
free-pro-team: '*'
+topics:
+ - api
---
The {% data variables.product.prodname_registry %} API enables you to manage packages using the REST API. To learn more about restoring or deleting packages, see "[Restoring and deleting packages](/packages/learn-github-packages/deleting-and-restoring-a-package)."
diff --git a/content/rest/reference/permissions-required-for-github-apps.md b/content/rest/reference/permissions-required-for-github-apps.md
index 25d9b58495..9f6a813ca7 100644
--- a/content/rest/reference/permissions-required-for-github-apps.md
+++ b/content/rest/reference/permissions-required-for-github-apps.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### About {% data variables.product.prodname_github_app %} permissions
diff --git a/content/rest/reference/projects.md b/content/rest/reference/projects.md
index 9ff76062b5..30b524f6e5 100644
--- a/content/rest/reference/projects.md
+++ b/content/rest/reference/projects.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% for operation in currentRestOperations %}
diff --git a/content/rest/reference/pulls.md b/content/rest/reference/pulls.md
index 2009b2db26..ebd99b432d 100644
--- a/content/rest/reference/pulls.md
+++ b/content/rest/reference/pulls.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The Pull Request API allows you to list, view, edit, create, and even merge pull requests. Comments on pull requests can be managed via the [Issue Comments API](/rest/reference/issues#comments).
diff --git a/content/rest/reference/rate-limit.md b/content/rest/reference/rate-limit.md
index 01e09ecc01..6b744f26b4 100644
--- a/content/rest/reference/rate-limit.md
+++ b/content/rest/reference/rate-limit.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The REST API overview documentation describes the [rate limit rules](/rest/overview/resources-in-the-rest-api#rate-limiting). You can check your current rate limit status at any time using the Rate Limit API described below.
diff --git a/content/rest/reference/reactions.md b/content/rest/reference/reactions.md
index 8992d99049..7ddd930ec4 100644
--- a/content/rest/reference/reactions.md
+++ b/content/rest/reference/reactions.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
### Reaction types
diff --git a/content/rest/reference/repos.md b/content/rest/reference/repos.md
index b0bab1f317..19579cf814 100644
--- a/content/rest/reference/repos.md
+++ b/content/rest/reference/repos.md
@@ -7,6 +7,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
{% for operation in currentRestOperations %}
diff --git a/content/rest/reference/scim.md b/content/rest/reference/scim.md
index fb032ed898..df50c65a89 100644
--- a/content/rest/reference/scim.md
+++ b/content/rest/reference/scim.md
@@ -4,6 +4,8 @@ redirect_from:
- /v3/scim
versions:
free-pro-team: '*'
+topics:
+ - api
---
### SCIM Provisioning for Organizations
diff --git a/content/rest/reference/search.md b/content/rest/reference/search.md
index fc289eac25..7de75572c3 100644
--- a/content/rest/reference/search.md
+++ b/content/rest/reference/search.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
The Search API helps you search for the specific item you want to find. For example, you can find a user or a specific file in a repository. Think of it the way you think of performing a search on Google. It's designed to help you find the one result you're looking for (or maybe the few results you're looking for). Just like searching on Google, you sometimes want to see a few pages of search results so that you can find the item that best meets your needs. To satisfy that need, the {% data variables.product.product_name %} Search API provides **up to 1,000 results for each search**.
diff --git a/content/rest/reference/teams.md b/content/rest/reference/teams.md
index 7223e949ec..7f6b2a3bf4 100644
--- a/content/rest/reference/teams.md
+++ b/content/rest/reference/teams.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
This API is only available to authenticated members of the team's [organization](/rest/reference/orgs). OAuth access tokens require the `read:org` [scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). {% data variables.product.prodname_dotcom %} generates the team's `slug` from the team `name`.
@@ -16,7 +18,7 @@ This API is only available to authenticated members of the team's [organization]
## Discussions
-The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. You can use team discussions to have conversations that are not specific to a repository or project. Any member of the team's [organization](/rest/reference/orgs) can create and read public discussion posts. For more details, see "[About team discussions](/articles/about-team-discussions/)." To learn more about commenting on a discussion post, see the [team discussion comments API](/rest/reference/teams#discussion-comments). This API is only available to authenticated members of the team's organization.
+The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. You can use team discussions to have conversations that are not specific to a repository or project. Any member of the team's [organization](/rest/reference/orgs) can create and read public discussion posts. For more details, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions/)." To learn more about commenting on a discussion post, see the [team discussion comments API](/rest/reference/teams#discussion-comments). This API is only available to authenticated members of the team's organization.
{% for operation in currentRestOperations %}
{% if operation.subcategory == 'discussions' %}{% include rest_operation %}{% endif %}
@@ -24,7 +26,7 @@ The team discussions API allows you to get, create, edit, and delete discussion
## Discussion comments
-The team discussion comments API allows you to get, create, edit, and delete discussion comments on a [team discussion](/rest/reference/teams#discussions) post. Any member of the team's [organization](/rest/reference/orgs) can create and read comments on a public discussion. For more details, see "[About team discussions](/articles/about-team-discussions/)." This API is only available to authenticated members of the team's organization.
+The team discussion comments API allows you to get, create, edit, and delete discussion comments on a [team discussion](/rest/reference/teams#discussions) post. Any member of the team's [organization](/rest/reference/orgs) can create and read comments on a public discussion. For more details, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions/)." This API is only available to authenticated members of the team's organization.
{% for operation in currentRestOperations %}
{% if operation.subcategory == 'discussion-comments' %}{% include rest_operation %}{% endif %}
diff --git a/content/rest/reference/users.md b/content/rest/reference/users.md
index 5371d5569c..a8be9cb182 100644
--- a/content/rest/reference/users.md
+++ b/content/rest/reference/users.md
@@ -6,6 +6,8 @@ versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
+topics:
+ - api
---
Many of the resources on the users API provide a shortcut for getting information about the currently authenticated user. If a request URL does not include a `{username}` parameter then the response will be for the logged in user (and you must pass [authentication information](/rest/overview/resources-in-the-rest-api#authentication) with your request).{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} Additional private information, such as whether a user has two-factor authentication enabled, is included when authenticated through basic auth or OAuth with the `user` scope.{% endif %}
diff --git a/contributing/search.md b/contributing/search.md
index 093a419341..46dece3114 100644
--- a/contributing/search.md
+++ b/contributing/search.md
@@ -14,8 +14,11 @@ To see all existing search-related issues and pull requests, visit [github.com/g
## How to search
-The site search is part of every version of docs.github.com. On any page, you can use the search box to search the documents we've indexed.
-You can also query our search endpoint directly at: https://docs.github.com/search?language=en&version=dotcom&query=jekyll
+The site search is part of every version of docs.github.com. On any page, you can use the search box to search the documents we've indexed.
+You can also query our search endpoint directly at: https://docs.github.com/search?version=dotcom&language=en&filters=topics:%27oauth%20apps%27+AND+topics:%27github%20apps%27&query=install
+
+Using the attribute `topics` in your query will only return results that have the matching topic value. You can find a full list of topics in [the allowed topics file](/data/allowed-topics.js). The `topics` attribute is configured as a [`filter only` facet in Algolia](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/). When the topic contains spaces, you must use quotes. For Algolia, [here](https://www.algolia.com/doc/api-reference/api-parameters/filters/#handle-attributes-with-spaces) is an example for filters containing spaces. Algolia also requires [boolean operators](https://www.algolia.com/doc/api-reference/api-parameters/filters) to combine more than one filter.
+
This endpoint responds in JSON format, and fronts Algolia and Lunr. We recommend using this endpoint over directly integrating with Algolia or Lunr, as the endpoint will be more stable.
## Production deploys
diff --git a/data/allowed-topics.js b/data/allowed-topics.js
new file mode 100644
index 0000000000..a309eccd03
--- /dev/null
+++ b/data/allowed-topics.js
@@ -0,0 +1,84 @@
+// This is an AllowList of topics that are approved for use in `topics`
+// frontmatter property. If a new topic is added to a Markdown file it must
+// also be added to this file.
+
+// The purpose of this list is to ensure we prevent typos and put a process in
+// place to keep a curated list of topics. This list also serves as a list of
+// available topics filters when using the search endpoint
+// (see /contributing/search#how-to-search)
+// If you'd like to add a new topic, consult the topic guidelines in the
+// content model, add the entry to this list, and ensure you loop in the
+// content and/or content strategy team for review.
+
+module.exports = [
+ '2fa',
+ 'Action development',
+ 'Amazon ECS',
+ 'Ant',
+ 'Azure App Service',
+ 'Azure Pipelines',
+ 'CD',
+ 'CI',
+ 'CircleCI',
+ 'Containers',
+ 'Docker',
+ 'Fundamentals',
+ 'GitLab',
+ 'Google Kubernetes Engine',
+ 'Gradle',
+ 'Java',
+ 'JavaScript',
+ 'Jenkins',
+ 'Maven',
+ 'Migration',
+ 'Node',
+ 'Packaging',
+ 'Powershell',
+ 'Project management',
+ 'Publishing',
+ 'Python',
+ 'Ruby',
+ 'Security',
+ 'Travis CI',
+ 'Workflows',
+ 'access management',
+ 'accounts',
+ 'api',
+ 'billing',
+ 'cli',
+ 'codespaces',
+ 'community',
+ 'desktop',
+ 'device verification',
+ 'early access',
+ 'enterprise',
+ 'events',
+ 'github',
+ 'github apps',
+ 'github search',
+ 'identity',
+ 'issues',
+ 'jobs',
+ 'legal',
+ 'marketplace',
+ 'mobile',
+ 'notifications',
+ 'oauth apps',
+ 'open source',
+ 'organizations',
+ 'pages',
+ 'permissions',
+ 'policy',
+ 'profile',
+ 'profiles',
+ 'projects',
+ 'pull requests',
+ 'repositories',
+ 'security',
+ 'sponsors',
+ 'ssh',
+ 'sso',
+ 'teams',
+ 'usernames',
+ 'webhooks'
+]
diff --git a/data/release-notes/2-21/16.yml b/data/release-notes/2-21/16.yml
new file mode 100644
index 0000000000..ac4c83fe6d
--- /dev/null
+++ b/data/release-notes/2-21/16.yml
@@ -0,0 +1,13 @@
+date: '2021-03-16'
+sections:
+ security_fixes:
+ - Packages have been updated to the latest security versions.
+ bugs:
+ - Importing of repository archives from GitHub Enterprise Server that are missing repository files would fail with an error.
+ known_issues:
+ - On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user.
+ - Custom firewall rules are not maintained during an upgrade.
+ - Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository.
+ - Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters.
+ - When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results.
+ - Security alerts are not reported when pushing to a repository on the command line.
diff --git a/data/release-notes/2-22/5.yml b/data/release-notes/2-22/5.yml
index 6801ba1b04..3498f14906 100644
--- a/data/release-notes/2-22/5.yml
+++ b/data/release-notes/2-22/5.yml
@@ -11,7 +11,7 @@ sections:
- 'The way SSH certificates were applied between Organizations and Businesses was inconsistent. {% comment %} https://github.com/github/github/pull/163423, https://github.com/github/github/pull/159538, https://github.com/github/authentication/issues/115 {% endcomment %}'
- 'When an account was rate limited due to using incorrect passwords, it could be locked out for up to 24 hours. {% comment %} https://github.com/github/github/pull/163433, https://github.com/github/github/pull/162938, https://github.com/github/github-ds/pull/51 {% endcomment %}'
- 'Pull request synchronization on repositories with many references could cause worker queues to fall behind. {% comment %} https://github.com/github/github/pull/163573, https://github.com/github/github/pull/163142 {% endcomment %}'
- - 'When signing in after attempting to visit a specific page, people were sent to the home page instead of their intended destination. {% comment %} https://github.com/github/github/pull/163782, https://github.com/github/github/pull/163579, https://github.com/github/github/pull/154117, https://github.com/github/ecosystem-apps/issues/1076 {% endcomment %}'
+ - 'When signing in with a local username and password (built-in authentication) after attempting to visit a specific page, the user was sent to the home page instead of their intended destination. {% comment %} https://github.com/github/github/pull/163782, https://github.com/github/github/pull/163579, https://github.com/github/github/pull/154117, https://github.com/github/ecosystem-apps/issues/1076 {% endcomment %}'
- 'For GHES instances using built-in authentication with an internal SAML identity provider, users without an associated email address could not create a commit from the web interface. {% comment %} https://github.com/github/github/pull/164009, https://github.com/github/github/pull/163530, https://github.com/github/github/issues/163524 {% endcomment %}'
known_issues:
- 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}'
diff --git a/data/release-notes/2-22/8.yml b/data/release-notes/2-22/8.yml
new file mode 100644
index 0000000000..d1f7ca16f3
--- /dev/null
+++ b/data/release-notes/2-22/8.yml
@@ -0,0 +1,14 @@
+date: '2021-03-16'
+sections:
+ security_fixes:
+ - Packages have been updated to the latest security versions.
+ bugs:
+ - Systemd journal logs were duplicated in multiple places.
+ - A site admin could get a 500 error page while trying to view issues referenced from private repositories.
+ - Importing of repository archives from GitHub Enterprise Server that are missing repository files would fail with an error.
+ known_issues:
+ - On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user.
+ - Custom firewall rules are not maintained during an upgrade.
+ - Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository.
+ - Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters.
+ - When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results.
diff --git a/data/release-notes/3-0/2.yml b/data/release-notes/3-0/2.yml
new file mode 100644
index 0000000000..95cc35dff7
--- /dev/null
+++ b/data/release-notes/3-0/2.yml
@@ -0,0 +1,27 @@
+date: '2021-03-16'
+sections:
+ security_fixes:
+ - Packages have been updated to the latest security versions.
+ bugs:
+ - During a backup an error "Warning: One or more storage objects were not found on the source appliance." was occurring when attempting to clean up purgeable storage objects.
+ - Dependency graph failed to parse `yarn.lock` JavaScript manifest files, resulting in HTTP 500 errors in logs.
+ - Disabling GitHub Actions would sometimes fail.
+ - Custom pre-receive hooks weren't allowed to write to `/tmp`, preventing some scripts from running correctly.
+ - Systemd journal logs were duplicated in multiple places.
+ - A timezone set on GitHub Enterprise 11.10.x or earlier was reset to UTC time after upgrading to 3.0 which caused timestamps to shift in some instances.
+ - Clicking "Publish your first package" in the packages sidebar on a repository would lead to an empty page.
+ - A site admin could get a 500 error page while trying to view issues referenced from private repositories.
+ - After disabling GitHub Packages, some organization pages would return an HTTP 500 error response.
+ - Importing of repository archives from GitHub Enterprise Server that are missing repository files would fail with an error.
+ - Repository [deploy keys](/developers/overview/managing-deploy-keys) were unable to be used with repositories containing LFS objects.
+ - In the packages sidebar of a repository, the Docker icon was gray and a tool tip displayed "This service is deprecated".
+ - Webhooks configured with a content type of `application/x-www-form-urlencoded` did not receive query parameters in the POST request body.
+ - Users could dismiss a mandatory message without checking all checkboxes.
+ known_issues:
+ - On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user.
+ - Custom firewall rules are not maintained during an upgrade.
+ - Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository.
+ - Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters.
+ - When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results.
+ - When maintenance mode is enabled, some services continue to be listed as "active processes". The services identified are expected to run during maintenance mode. If you experience this issue and are unsure, contact [GitHub Enterprise Support](https://enterprise.githubsupport.com/hc/en-us) or [GitHub Premium Support](https://premium.githubsupport.com/).
+ - Juypter Notebook rendering in the web UI may fail if the notebook includes non UTF-8 encoded characters.
diff --git a/data/reusables/actions/actions-audit-events-for-enterprise.md b/data/reusables/actions/actions-audit-events-for-enterprise.md
index fc57d1e2da..2c0c30d196 100644
--- a/data/reusables/actions/actions-audit-events-for-enterprise.md
+++ b/data/reusables/actions/actions-audit-events-for-enterprise.md
@@ -1,10 +1,12 @@
| Action | Description
|------------------|-------------------
-| `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)."
-| `runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an enterprise](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise).
+| `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed.
+| `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."
+| `runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[About self-hosted runner groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#about-self-hosted-runner-groups).
| `runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)."
-| `runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group.
+| `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group.
| `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)."
+| `runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."
| `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."
| `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."
diff --git a/data/reusables/actions/choose-repo.md b/data/reusables/actions/choose-repo.md
new file mode 100644
index 0000000000..362868f66b
--- /dev/null
+++ b/data/reusables/actions/choose-repo.md
@@ -0,0 +1 @@
+Choose a repository where you want to apply this project management workflow. You can use an existing repository that you have write access to, or you can create a new repository. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)."
\ No newline at end of file
diff --git a/data/reusables/actions/commit-workflow.md b/data/reusables/actions/commit-workflow.md
new file mode 100644
index 0000000000..fe2ce9b187
--- /dev/null
+++ b/data/reusables/actions/commit-workflow.md
@@ -0,0 +1 @@
+Commit your workflow file to the default branch of your repository. For more information, see "[Creating new files](/github/managing-files-in-a-repository/creating-new-files)."
\ No newline at end of file
diff --git a/data/reusables/actions/make-workflow-file.md b/data/reusables/actions/make-workflow-file.md
new file mode 100644
index 0000000000..82be838ded
--- /dev/null
+++ b/data/reusables/actions/make-workflow-file.md
@@ -0,0 +1 @@
+In your repository, create a file called `.github/workflows/YOUR_WORKFLOW.yml`, replacing `YOUR_WORKFLOW` with a name of your choice. This is a workflow file. For more information about creating new files on GitHub, see "[Creating new files](/github/managing-files-in-a-repository/creating-new-files)."
\ No newline at end of file
diff --git a/data/reusables/actions/schedule-delay.md b/data/reusables/actions/schedule-delay.md
new file mode 100644
index 0000000000..ecbd927178
--- /dev/null
+++ b/data/reusables/actions/schedule-delay.md
@@ -0,0 +1,5 @@
+{% note %}
+
+Note: The `schedule` event can be delayed during periods of high loads of {% data variables.product.prodname_actions %} workflow runs.
+
+{% endnote %}
diff --git a/data/reusables/actions/workflow-runs-dependabot-note.md b/data/reusables/actions/workflow-runs-dependabot-note.md
index 1e61585baa..bbf085d6bf 100644
--- a/data/reusables/actions/workflow-runs-dependabot-note.md
+++ b/data/reusables/actions/workflow-runs-dependabot-note.md
@@ -1,7 +1,7 @@
{% if currentVersion == "free-pro-team@latest" %}
{% note %}
-**Note:** Pull requests for {% data variables.product.prodname_dependabot %} version updates will trigger workflow runs with a read-only `GITHUB_TOKEN`. These workflow runs will not be granted access to any secrets.
+**Note:** Workflow runs triggered by {% data variables.product.prodname_dependabot %} pull requests run as if they are from a forked repository, and therefore use a read-only `GITHUB_TOKEN`. These workflow runs cannot access any secrets. See ["Keeping your GitHub Actions and workflows secure: Preventing pwn requests"](https://securitylab.github.com/research/github-actions-preventing-pwn-requests) for strategies to keep these workflows secure.
{% endnote %}
{% endif %}
diff --git a/data/reusables/advanced-security/note-org-enable-uses-seats.md b/data/reusables/advanced-security/note-org-enable-uses-seats.md
index f93772d5b7..ff72be9b61 100644
--- a/data/reusables/advanced-security/note-org-enable-uses-seats.md
+++ b/data/reusables/advanced-security/note-org-enable-uses-seats.md
@@ -1,6 +1,6 @@
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}
{% note %}
-**Note:** If you enable {% data variables.product.prodname_GH_advanced_security %}, committers to these repositories will use seats on your {% data variables.product.prodname_GH_advanced_security %} license. This option is disabled if you have exceeded your license capacity. For more information, see "[About licensing for {% data variables.product.prodname_GH_advanced_security %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security)."
+**Note:** If you enable {% data variables.product.prodname_GH_advanced_security %}, committers to these repositories will use seats on your {% data variables.product.prodname_GH_advanced_security %} license. This option is disabled if you have exceeded your license capacity. {% if currentVersion == "free-pro-team@latest" %}For more information, see "[About licensing for {% data variables.product.prodname_GH_advanced_security %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-licensing-for-github-advanced-security)."{% endif %}
{% endnote %}
{% endif %}
\ No newline at end of file
diff --git a/data/reusables/code-scanning/codeql-runner-analyze-example.md b/data/reusables/code-scanning/codeql-runner-analyze-example.md
new file mode 100644
index 0000000000..01e6a97f91
--- /dev/null
+++ b/data/reusables/code-scanning/codeql-runner-analyze-example.md
@@ -0,0 +1,25 @@
+1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. The results will appear in the **Security** tab for your repository.
+
+ ```shell
+ $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo
+ --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+ --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/my-branch
+ > Finalizing database creation
+ > ...
+ > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms
+ > Successfully uploaded results
+ ```
+
+1. To upload {% data variables.product.prodname_code_scanning %} results as pull request checks, specify the pull request using the `--ref` flag. We recommend setting up the {% data variables.product.prodname_codeql_runner %} so that it runs on the [`pull_request`](/developers/webhooks-and-events/webhook-events-and-payloads#pull_request) webhook event.
+
+ ```shell
+ $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo
+ --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+ --commit 1dc7a1346e5ce7b86835b68bbda3078b37d6abbe --ref refs/pull/123/merge
+ > Finalizing database creation
+ > ...
+ > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms
+ > Successfully uploaded results
+ ```
+
+For more information about viewing {% data variables.product.prodname_code_scanning %} alerts, see "[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" and "[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)."
diff --git a/data/reusables/developer-site/pull_request_forked_repos_link.md b/data/reusables/developer-site/pull_request_forked_repos_link.md
index 144420eb2f..54d745b497 100644
--- a/data/reusables/developer-site/pull_request_forked_repos_link.md
+++ b/data/reusables/developer-site/pull_request_forked_repos_link.md
@@ -11,3 +11,9 @@ When you create a pull request from a forked repository to the base repository,
Workflows don't run on forked repositories by default. You must enable GitHub Actions in the **Actions** tab of the forked repository.
{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
+
+{% note %}
+
+**Note:** Workflows triggered by {% data variables.product.prodname_dependabot %} pull requests are treated as though they are from a forked repository, and are also subject to these restrictions.
+
+{% endnote %}
diff --git a/data/reusables/gated-features/ghas.md b/data/reusables/gated-features/ghas.md
new file mode 100644
index 0000000000..fcf1b455c7
--- /dev/null
+++ b/data/reusables/gated-features/ghas.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_GH_advanced_security %} licenses are available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% if currentVersion == "github-ae@latest" %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_GH_advanced_security %} is also included in {% data variables.product.prodname_ghe_one %}{% if currentVersion == "free-pro-team@latest" %} and in all public repositories on {% data variables.product.prodname_dotcom_the_website %}{% endif %}. For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)."
\ No newline at end of file
diff --git a/data/reusables/github-actions/supported-github-runners.md b/data/reusables/github-actions/supported-github-runners.md
index 3af3da15cb..514e6e3e37 100644
--- a/data/reusables/github-actions/supported-github-runners.md
+++ b/data/reusables/github-actions/supported-github-runners.md
@@ -1,8 +1,8 @@
| Virtual environment | YAML workflow label |
| --------------------|---------------------|
| Windows Server 2019 | `windows-latest` or `windows-2019` |
-| Ubuntu 20.04 | `ubuntu-latest` (see note) or `ubuntu-20.04` |
-| Ubuntu 18.04 | `ubuntu-latest` (see note) or `ubuntu-18.04` |
+| Ubuntu 20.04 | `ubuntu-latest` or `ubuntu-20.04` |
+| Ubuntu 18.04 | `ubuntu-18.04` |
| Ubuntu 16.04 | `ubuntu-16.04` |
| macOS Big Sur 11.0 | `macos-11.0` |
| macOS Catalina 10.15 | `macos-latest` or `macos-10.15` |
diff --git a/data/reusables/github-actions/ubuntu-runner-preview.md b/data/reusables/github-actions/ubuntu-runner-preview.md
deleted file mode 100644
index 6eb91edc13..0000000000
--- a/data/reusables/github-actions/ubuntu-runner-preview.md
+++ /dev/null
@@ -1,5 +0,0 @@
-{% note %}
-
-**Note:** The `ubuntu-latest` label is currently being migrated from the Ubuntu 18.04 virtual environment to Ubuntu 20.04. Specifying the `ubuntu-latest` label during the migration might use either virtual environment. To explicitly use Ubuntu 20.04 or Ubuntu 18.04, specify `ubuntu-20.04` or `ubuntu-18.04`. When the migration is complete, `ubuntu-latest` will use the Ubuntu 20.04 virtual environment. For more information about the migration, see "[Ubuntu-latest workflows will use Ubuntu-20.04](https://github.com/actions/virtual-environments/issues/1816)."
-
-{% endnote %}
diff --git a/data/reusables/mobile/push-notifications-on-ghes.md b/data/reusables/mobile/push-notifications-on-ghes.md
index 94535c20d3..954c32fc7b 100644
--- a/data/reusables/mobile/push-notifications-on-ghes.md
+++ b/data/reusables/mobile/push-notifications-on-ghes.md
@@ -1 +1 @@
-For {% data variables.product.prodname_ghe_server %}, push notifications for direct mentions are currently supported on iOS and coming soon to Android. {% data variables.product.prodname_ghe_server %} uses background fetch to support push notifications without sending your information to a third-party service, so you may experience a delay in receiving push notifications.
\ No newline at end of file
+{% data variables.product.prodname_ghe_server %} uses background fetch to support push notifications without sending your information to a third-party service, so you may experience a delay in receiving push notifications.
\ No newline at end of file
diff --git a/data/reusables/organizations/team-discussions-are-for-orgs.md b/data/reusables/organizations/team-discussions-are-for-orgs.md
index e2d9192787..cb0f53f8ed 100644
--- a/data/reusables/organizations/team-discussions-are-for-orgs.md
+++ b/data/reusables/organizations/team-discussions-are-for-orgs.md
@@ -1 +1 @@
-Team discussions are only available on team pages in organizations. For more information, see "[About team discussions](/articles/about-team-discussions)."
+Team discussions are only available on team pages in organizations. For more information, see "[About team discussions](/github/setting-up-and-managing-organizations-and-teams/about-team-discussions)."
diff --git a/data/reusables/webhooks/workflow_desc.md b/data/reusables/webhooks/workflow_desc.md
new file mode 100644
index 0000000000..6f716dbe56
--- /dev/null
+++ b/data/reusables/webhooks/workflow_desc.md
@@ -0,0 +1 @@
+`workflow` | `object` | The workflow that generated the workflow run.
diff --git a/data/reusables/webhooks/workflow_run_desc.md b/data/reusables/webhooks/workflow_run_desc.md
index 8866577116..486a20dcd1 100644
--- a/data/reusables/webhooks/workflow_run_desc.md
+++ b/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,5 @@
+This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. A workflow run is triggered regardless of the result of the previous workflow.
-This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
+For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
+The workflow started by the `workflow_run` event is able to access secrets and write tokens, even if the previous workflow was not. This is useful in cases where the previous workflow is intentionally not privileged, but you need to take a privileged action in a later workflow.
diff --git a/data/reusables/webhooks/workflow_run_properties.md b/data/reusables/webhooks/workflow_run_properties.md
new file mode 100644
index 0000000000..1ff99e14f5
--- /dev/null
+++ b/data/reusables/webhooks/workflow_run_properties.md
@@ -0,0 +1,4 @@
+Key | Type | Description
+----|------|-------------
+`action`|`string` | The action that was performed. Can be one of `requested` or `completed`.
+`workflow_run`| `object` | The workflow run. Many `workflow_run` keys, such as `head_branch`, `conclusion`, and `pull_requests` are the same as those in a [`check_suite`](#check_suite) object.
diff --git a/includes/head.html b/includes/head.html
index 5d931a9048..0cd6b63fad 100644
--- a/includes/head.html
+++ b/includes/head.html
@@ -11,6 +11,9 @@
{% if page.intro %}
{% endif %}
+ {% if page.topics %}
+
+ {% endif %}
{% if page.hidden %}
{% endif %}
diff --git a/javascripts/display-platform-specific-content.js b/javascripts/display-platform-specific-content.js
index 0e7035eba5..841d1cbdae 100644
--- a/javascripts/display-platform-specific-content.js
+++ b/javascripts/display-platform-specific-content.js
@@ -12,6 +12,7 @@ export default function displayPlatformSpecificContent () {
if (platform === 'darwin') platform = 'mac'
if (platform === 'ios') platform = 'mac'
if (platform === 'android') platform = 'linux'
+ if (platform === 'cros') platform = 'linux'
if (platform.startsWith('win')) platform = 'windows'
const platformsInContent = findPlatformSpecificContent(platform)
diff --git a/javascripts/search.js b/javascripts/search.js
index 760bce874b..edc7def535 100644
--- a/javascripts/search.js
+++ b/javascripts/search.js
@@ -261,8 +261,8 @@ function tmplSearchResult ({ url, breadcrumbs, heading, title, content }) {
{ href: url, class: 'no-underline' },
div(
{ class: 'search-result-breadcrumbs d-block text-gray-dark opacity-60 text-small pb-1' },
- // Remove redundant title from the end of breadcrumbs
- markify((breadcrumbs || '').replace(` / ${title}`, ''))
+ // Breadcrumbs in search records don't include the page title
+ markify(breadcrumbs || '')
),
div(
{ class: 'search-result-title d-block h4-mktg text-gray-dark' },
diff --git a/javascripts/user-agent.js b/javascripts/user-agent.js
index 659dd1a66d..2f76724992 100644
--- a/javascripts/user-agent.js
+++ b/javascripts/user-agent.js
@@ -6,6 +6,7 @@ const OS_REGEXPS = [
/(mac) os x ([^);]+)/i,
/(windows) ([^);]+)/i,
/(android) ([^);]+)/i,
+ /(cros) ([^);]+)/i,
/(linux) ([^);]+)/i
]
diff --git a/lib/enterprise-server-releases.js b/lib/enterprise-server-releases.js
index 3e6f83c31a..0e620ec0c5 100644
--- a/lib/enterprise-server-releases.js
+++ b/lib/enterprise-server-releases.js
@@ -4,6 +4,9 @@ const versionSatisfiesRange = require('./version-satisfies-range')
// enterprise-releases/docs/supported-versions.md#release-lifecycle-dates
const dates = require('../lib/enterprise-dates.json')
+// Some frontmatter may contain the upcoming GHES release number
+const next = '3.1'
+
const supported = [
'3.0',
'2.22',
@@ -57,6 +60,7 @@ const deprecatedReleasesWithNewFormat = deprecated.filter(version => versionSati
const deprecatedReleasesOnDeveloperSite = deprecated.filter(version => versionSatisfiesRange(version, '<=2.16'))
module.exports = {
+ next,
supported,
deprecated,
legacyAssetVersions,
diff --git a/lib/get-applicable-versions.js b/lib/get-applicable-versions.js
index a05880799e..ec64f109ff 100644
--- a/lib/get-applicable-versions.js
+++ b/lib/get-applicable-versions.js
@@ -1,4 +1,5 @@
const allVersions = require('./all-versions')
+const { next } = require('./enterprise-server-releases')
const versionSatisfiesRange = require('./version-satisfies-range')
// return an array of versions that an article's product versions encompasses
@@ -15,6 +16,8 @@ function getApplicableVersions (frontmatterVersions, filepath) {
// get an array like: [ 'free-pro-team@latest', 'enterprise-server@2.21', 'enterprise-cloud@latest' ]
const applicableVersions = []
+ let nextVersion = false
+
// where frontmatter is something like:
// free-pro-team: '*'
// enterprise-server: '>=2.19'
@@ -23,6 +26,15 @@ function getApplicableVersions (frontmatterVersions, filepath) {
// ^ where each key corresponds to a plan
Object.entries(frontmatterVersions)
.forEach(([plan, planValue]) => {
+ // Special handling for frontmatter that evalues to the next GHES release number or a hardcoded `next`:
+ // we don't want to return it in the applicable versions array or it will become a permalink,
+ // but we also don't want to throw an error if no other versions are found.
+ if (planValue !== '*') {
+ if (versionSatisfiesRange(next, planValue) || planValue === 'next') {
+ nextVersion = true
+ }
+ }
+
// for each plan (e.g., enterprise-server), get matching versions from allVersions object
const relevantVersions = Object.values(allVersions).filter(v => v.plan === plan)
@@ -42,7 +54,7 @@ function getApplicableVersions (frontmatterVersions, filepath) {
})
})
- if (!applicableVersions.length) {
+ if (!applicableVersions.length && !nextVersion) {
throw new Error(`No applicable versions found for ${filepath}. Please double-check the page's \`versions\` frontmatter.`)
}
diff --git a/lib/rest/static/decorated/api.github.com.json b/lib/rest/static/decorated/api.github.com.json
index e71e5b02e2..c32bca4754 100644
--- a/lib/rest/static/decorated/api.github.com.json
+++ b/lib/rest/static/decorated/api.github.com.json
@@ -2498,6 +2498,16 @@
"default": 1
},
"descriptionHTML": "
Page number of the results to fetch.
"
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ },
+ "descriptionHTML": "
"
+ },
+ {
+ "name": "state",
+ "in": "query",
+ "required": false,
+ "description": "The state of the package, either active or deleted.",
+ "schema": {
+ "type": "string",
+ "enum": [
+ "active",
+ "deleted"
+ ],
+ "default": "active"
+ },
+ "descriptionHTML": "
The state of the package, either active or deleted.
"
}
],
"x-codeSamples": [
@@ -22668,7 +22839,7 @@
"tags": [
"packages"
],
- "operationId": "packages/get-all-package-versions-for-a-package-owned-by-an-org",
+ "operationId": "packages/get-all-package-versions-for-package-owned-by-org",
"externalDocs": {
"description": "API method documentation",
"url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
@@ -23596,7 +23767,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -23611,7 +23782,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -23750,7 +23921,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -23794,17 +23965,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -23814,7 +23985,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -23975,7 +24146,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -24026,7 +24197,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -24194,7 +24365,7 @@
}
],
"summary": "Get GitHub Actions billing for an organization",
- "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `repo` or `admin:org` scope.",
+ "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `repo` or `admin:org` scope.",
"operationId": "billing/get-github-actions-billing-org",
"tags": [
"billing"
@@ -24215,7 +24386,7 @@
"categoryLabel": "Billing",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Gets the summary of the free and paid GitHub Actions minutes used.
\n
Paid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"Managing billing for GitHub Actions\".
\n
Access tokens must have the repo or admin:org scope.
",
+ "descriptionHTML": "
Gets the summary of the free and paid GitHub Actions minutes used.
\n
Paid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"Managing billing for GitHub Actions\".
\n
Access tokens must have the repo or admin:org scope.
"
}
],
"x-codeSamples": [
@@ -41866,7 +42046,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -41876,6 +42056,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -45847,7 +46028,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -45861,6 +46042,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -45881,7 +46063,7 @@
}
],
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -45902,7 +46084,7 @@
"categoryLabel": "Code scanning",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used ref in the request).
",
+ "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used ref in the request).
",
"responses": [
{
"httpStatusCode": "200",
@@ -46274,7 +46456,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
}
@@ -46411,7 +46593,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the analyses you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -46618,7 +46800,8 @@
"description": "Allow deletion if the specified analysis is the last in a set. The parameter can be used without a value as the parameter value is not considered. If you attempt to delete the final analysis in a set without using this parameter you'll get a 400 response with the message: `Analysis is last of its type and deletion may result in the loss of historical alert data. Please specify confirm_delete.`",
"required": false,
"schema": {
- "type": "string"
+ "type": "string",
+ "nullable": true
},
"descriptionHTML": "
Allow deletion if the specified analysis is the last in a set. The parameter can be used without a value as the parameter value is not considered. If you attempt to delete the final analysis in a set without using this parameter you'll get a 400 response with the message: Analysis is last of its type and deletion may result in the loss of historical alert data. Please specify confirm_delete.
"
}
@@ -46723,7 +46906,7 @@
}
],
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -46752,11 +46935,11 @@
},
"ref": {
"type": "string",
- "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>.
",
+ "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>,\nrefs/pull/<number>/merge, or refs/pull/<number>/head.
",
"name": "ref",
"in": "body",
"rawType": "string",
- "rawDescription": "The full Git reference, formatted as `refs/heads/`.",
+ "rawDescription": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`.",
"childParamsGroups": []
},
"sarif": {
@@ -46818,7 +47001,7 @@
"category": "code-scanning",
"categoryLabel": "Code scanning",
"notes": [],
- "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
+ "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
There are two places where you can upload code scanning results.
\n
\n
If you upload to a pull request, for example --ref refs/pull/42/merge or --ref refs/pull/42/head, then the results appear as alerts in a pull request check. For more information, see \"Triaging code scanning alerts in pull requests.\"
\n
If you upload to a branch, for example --ref refs/heads/my-branch, then the results appear in the Security tab for your repository. For more information, see \"Managing code scanning alerts for your repository.\"
\n
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
"bodyParameters": [
{
"description": "
Required. The SHA of the commit to which the analysis you are uploading relates.
"
}
],
"x-codeSamples": [
@@ -74026,6 +74448,7 @@
"schema": {
"type": "string",
"enum": [
+ "",
"day",
"week"
],
@@ -74266,6 +74689,7 @@
"schema": {
"type": "string",
"enum": [
+ "",
"day",
"week"
],
@@ -74799,7 +75223,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -74894,7 +75318,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -74982,7 +75406,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -75003,7 +75427,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
"
+ },
+ {
+ "name": "state",
+ "in": "query",
+ "required": false,
+ "description": "The state of the package, either active or deleted.",
+ "schema": {
+ "type": "string",
+ "enum": [
+ "active",
+ "deleted"
+ ],
+ "default": "active"
+ },
+ "descriptionHTML": "
The state of the package, either active or deleted.
"
}
],
"x-codeSamples": [
@@ -89253,7 +89763,7 @@
"tags": [
"packages"
],
- "operationId": "packages/get-all-package-versions-for-a-package-owned-by-the-authenticated-user",
+ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user",
"externalDocs": {
"description": "API method documentation",
"url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
@@ -89824,7 +90334,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -89836,7 +90346,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -89851,7 +90361,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -89865,7 +90375,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -90021,7 +90531,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -90064,13 +90574,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -90244,7 +90754,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -93044,7 +93554,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -93072,7 +93582,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
",
"responses": [
{
"httpStatusCode": "200",
@@ -93110,7 +93620,7 @@
}
],
"summary": "Get GitHub Actions billing for a user",
- "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `user` scope.",
+ "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `user` scope.",
"operationId": "billing/get-github-actions-billing-user",
"tags": [
"billing"
@@ -93131,7 +93641,7 @@
"categoryLabel": "Billing",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Gets the summary of the free and paid GitHub Actions minutes used.
\n
Paid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"Managing billing for GitHub Actions\".
\n
Access tokens must have the user scope.
",
+ "descriptionHTML": "
Gets the summary of the free and paid GitHub Actions minutes used.
\n
Paid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"Managing billing for GitHub Actions\".
"
}
],
"x-codeSamples": [
@@ -15339,7 +15503,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -15354,7 +15518,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -15493,7 +15657,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -15537,17 +15701,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -15557,7 +15721,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -15718,7 +15882,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -15769,7 +15933,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -24860,7 +25024,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -24870,6 +25034,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -30124,6 +30289,28 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -53043,7 +53477,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.18/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.18/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -53138,7 +53572,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -53214,7 +53648,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -53226,7 +53660,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -53242,7 +53676,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.18/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.18/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -53263,7 +53697,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -60390,6 +60824,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -61547,7 +61982,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -61559,7 +61994,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -61574,7 +62009,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -61588,7 +62023,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -61744,7 +62179,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.18/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -61787,13 +62222,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -61967,7 +62402,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -64498,7 +64933,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -64526,7 +64961,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -15435,7 +15599,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -15450,7 +15614,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -15589,7 +15753,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -15633,17 +15797,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -15653,7 +15817,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -15814,7 +15978,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -15865,7 +16029,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -25427,7 +25591,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -25437,6 +25601,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -30691,6 +30856,28 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -53845,7 +54279,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.19/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.19/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -53940,7 +54374,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -54016,7 +54450,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -54028,7 +54462,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -54044,7 +54478,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.19/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.19/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -54065,7 +54499,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -60980,6 +61414,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -62137,7 +62572,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -62149,7 +62584,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -62164,7 +62599,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -62178,7 +62613,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -62334,7 +62769,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.19/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -62377,13 +62812,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -62557,7 +62992,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -65088,7 +65523,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -65116,7 +65551,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -15909,7 +16073,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -15924,7 +16088,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -16063,7 +16227,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -16107,17 +16271,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -16127,7 +16291,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -16288,7 +16452,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -16339,7 +16503,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -25901,7 +26065,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -25911,6 +26075,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -31165,6 +31330,28 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -54501,7 +54935,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.20/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.20/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -54596,7 +55030,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -54672,7 +55106,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -54684,7 +55118,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -54700,7 +55134,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.20/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.20/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -54721,7 +55155,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -61542,6 +61976,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -62699,7 +63134,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -62711,7 +63146,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -62726,7 +63161,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -62740,7 +63175,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -62896,7 +63331,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.20/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -62939,13 +63374,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -63119,7 +63554,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -65650,7 +66085,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -65678,7 +66113,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -15903,7 +16067,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -15918,7 +16082,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -16057,7 +16221,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -16101,17 +16265,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -16121,7 +16285,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -16282,7 +16446,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -16333,7 +16497,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -17203,6 +17367,16 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -58545,7 +58989,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.21/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.21/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -58640,7 +59084,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -58716,7 +59160,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -58728,7 +59172,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -58744,7 +59188,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.21/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.21/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -58765,7 +59209,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -65760,6 +66204,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -66917,7 +67362,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -66929,7 +67374,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -66944,7 +67389,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -66958,7 +67403,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -67114,7 +67559,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.21/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -67157,13 +67602,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -67337,7 +67782,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -69868,7 +70313,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -69896,7 +70341,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -20108,7 +20312,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -20123,7 +20327,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -20262,7 +20466,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -20306,17 +20510,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -20326,7 +20530,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -20487,7 +20691,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -20538,7 +20742,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -21408,6 +21612,16 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -36311,7 +36525,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -36321,6 +36535,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -40355,7 +40570,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -40369,6 +40584,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -40389,7 +40605,7 @@
}
],
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -40410,7 +40626,7 @@
"categoryLabel": "Code scanning",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used ref in the request).
",
+ "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used ref in the request).
",
"responses": [
{
"httpStatusCode": "200",
@@ -40792,7 +41008,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the analyses you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -40905,7 +41121,7 @@
}
],
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -40934,11 +41150,11 @@
},
"ref": {
"type": "string",
- "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>.
",
+ "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>,\nrefs/pull/<number>/merge, or refs/pull/<number>/head.
",
"name": "ref",
"in": "body",
"rawType": "string",
- "rawDescription": "The full Git reference, formatted as `refs/heads/`.",
+ "rawDescription": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`.",
"childParamsGroups": []
},
"sarif": {
@@ -41000,7 +41216,7 @@
"category": "code-scanning",
"categoryLabel": "Code scanning",
"notes": [],
- "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
+ "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
There are two places where you can upload code scanning results.
\n
\n
If you upload to a pull request, for example --ref refs/pull/42/merge or --ref refs/pull/42/head, then the results appear as alerts in a pull request check. For more information, see \"Triaging code scanning alerts in pull requests.\"
\n
If you upload to a branch, for example --ref refs/heads/my-branch, then the results appear in the Security tab for your repository. For more information, see \"Managing code scanning alerts for your repository.\"
\n
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
"bodyParameters": [
{
"description": "
Required. The SHA of the commit to which the analysis you are uploading relates.
"
}
],
"x-codeSamples": [
@@ -66222,7 +66707,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.22/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@2.22/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -66317,7 +66802,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -66393,7 +66878,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -66405,7 +66890,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -66421,7 +66906,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.22/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@2.22/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -66442,7 +66927,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -73388,6 +73873,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -74546,7 +75032,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -74558,7 +75044,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -74573,7 +75059,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -74587,7 +75073,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -74743,7 +75229,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@2.22/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -74786,13 +75272,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -74966,7 +75452,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -77480,7 +77966,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -77508,7 +77994,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -24038,7 +24242,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -24053,7 +24257,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -24192,7 +24396,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -24236,17 +24440,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -24256,7 +24460,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -24417,7 +24621,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -24468,7 +24672,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -25338,6 +25542,16 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -40826,7 +41040,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -40836,6 +41050,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -44807,7 +45022,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -44821,6 +45036,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -44841,7 +45057,7 @@
}
],
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -44862,7 +45078,7 @@
"categoryLabel": "Code scanning",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used ref in the request).
",
+ "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used ref in the request).
",
"responses": [
{
"httpStatusCode": "200",
@@ -45244,7 +45460,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the analyses you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -45357,7 +45573,7 @@
}
],
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -45386,11 +45602,11 @@
},
"ref": {
"type": "string",
- "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>.
",
+ "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>,\nrefs/pull/<number>/merge, or refs/pull/<number>/head.
",
"name": "ref",
"in": "body",
"rawType": "string",
- "rawDescription": "The full Git reference, formatted as `refs/heads/`.",
+ "rawDescription": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`.",
"childParamsGroups": []
},
"sarif": {
@@ -45452,7 +45668,7 @@
"category": "code-scanning",
"categoryLabel": "Code scanning",
"notes": [],
- "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
+ "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
There are two places where you can upload code scanning results.
\n
\n
If you upload to a pull request, for example --ref refs/pull/42/merge or --ref refs/pull/42/head, then the results appear as alerts in a pull request check. For more information, see \"Triaging code scanning alerts in pull requests.\"
\n
If you upload to a branch, for example --ref refs/heads/my-branch, then the results appear in the Security tab for your repository. For more information, see \"Managing code scanning alerts for your repository.\"
\n
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
"bodyParameters": [
{
"description": "
Required. The SHA of the commit to which the analysis you are uploading relates.
"
}
],
"x-codeSamples": [
@@ -70918,7 +71403,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@3.0/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/enterprise-server@3.0/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -71013,7 +71498,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -71089,7 +71574,7 @@
},
{
"name": "visibility",
- "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`.",
+ "description": "Specifies the types of repositories to return. Can be one of `all` or `public`. Default: `public`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.",
"in": "query",
"required": false,
"schema": {
@@ -71101,7 +71586,7 @@
"public"
]
},
- "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public.
"
+ "descriptionHTML": "
Specifies the types of repositories to return. Can be one of all or public. Default: public. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
"
}
],
"x-codeSamples": [
@@ -71117,7 +71602,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@3.0/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@3.0/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -71138,7 +71623,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
\n
",
"responses": [
{
"httpStatusCode": "200",
@@ -78084,6 +78569,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -79242,7 +79728,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -79254,7 +79740,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -79269,7 +79755,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -79283,7 +79769,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -79439,7 +79925,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/enterprise-server@3.0/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -79482,13 +79968,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -79662,7 +80148,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -82176,7 +82662,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -82204,7 +82690,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
"
}
],
"x-codeSamples": [
@@ -16392,6 +16493,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -17943,7 +18045,7 @@
},
{
"name": "type",
- "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
+ "description": "Specifies the types of repositories you want returned. Can be one of `all`, `public`, `private`, `forks`, `sources`, `member`, `internal`. Note: For GitHub AE, can be one of `all`, `private`, `forks`, `sources`, `member`, `internal`. Default: `all`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `type` can also be `internal`.",
"in": "query",
"required": false,
"schema": {
@@ -17958,7 +18060,7 @@
"internal"
]
},
- "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
+ "descriptionHTML": "
Specifies the types of repositories you want returned. Can be one of all, public, private, forks, sources, member, internal. Note: For GitHub AE, can be one of all, private, forks, sources, member, internal. Default: all. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, type can also be internal.
"
},
{
"name": "sort",
@@ -18097,7 +18199,7 @@
}
],
"summary": "Create an organization repository",
- "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository in the specified organization. The authenticated user must be a member of the organization.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -18141,17 +18243,17 @@
},
"private": {
"type": "boolean",
- "description": "
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"visibility": {
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -18161,7 +18263,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
"has_issues": {
@@ -18322,7 +18424,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository in the specified organization. The authenticated user must be a member of the organization.
Either true to create a private repository or false to create a public one.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Either `true` to create a private repository or `false` to create a public one.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
"type": "string",
- "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
+ "description": "
Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"Creating an internal repository\" in the GitHub Help documentation. \nThe visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.
",
"enum": [
"public",
"private",
@@ -18373,7 +18475,7 @@
"name": "visibility",
"in": "body",
"rawType": "string",
- "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
+ "rawDescription": "Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, `visibility` can also be `internal`. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see \"[Creating an internal repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)\" in the GitHub Help documentation. \nThe `visibility` parameter overrides the `private` parameter when you use both parameters with the `nebula-preview` preview header.",
"childParamsGroups": []
},
{
@@ -19243,6 +19345,16 @@
"default": 1
},
"descriptionHTML": "
"
}
],
"x-codeSamples": [
@@ -34966,7 +35078,7 @@
"name",
"head_sha"
],
- "anyOf": [
+ "oneOf": [
{
"properties": {
"status": {
@@ -34976,6 +35088,7 @@
}
},
"required": [
+ "status",
"conclusion"
],
"additionalProperties": true
@@ -38947,7 +39060,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -38961,6 +39074,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -38981,7 +39095,7 @@
}
],
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -39002,7 +39116,7 @@
"categoryLabel": "Code scanning",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used ref in the request).
",
+ "descriptionHTML": "
Lists all open code scanning alerts for the default branch (usually main\nor master). You must use an access token with the security_events scope to use\nthis endpoint. GitHub Apps must have the security_events read permission to use\nthis endpoint.
\n
The response includes a most_recent_instance object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used ref in the request).
",
"responses": [
{
"httpStatusCode": "200",
@@ -39374,7 +39488,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
}
@@ -39511,7 +39625,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"descriptionHTML": "
The Git reference for the analyses you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.
"
},
@@ -39716,7 +39830,7 @@
}
],
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -39745,11 +39859,11 @@
},
"ref": {
"type": "string",
- "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>.
",
+ "description": "
Required. The full Git reference, formatted as refs/heads/<branch name>,\nrefs/pull/<number>/merge, or refs/pull/<number>/head.
",
"name": "ref",
"in": "body",
"rawType": "string",
- "rawDescription": "The full Git reference, formatted as `refs/heads/`.",
+ "rawDescription": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`.",
"childParamsGroups": []
},
"sarif": {
@@ -39811,7 +39925,7 @@
"category": "code-scanning",
"categoryLabel": "Code scanning",
"notes": [],
- "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
+ "descriptionHTML": "
Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the security_events scope to use this endpoint. GitHub Apps must have the security_events write permission to use this endpoint.
\n
There are two places where you can upload code scanning results.
\n
\n
If you upload to a pull request, for example --ref refs/pull/42/merge or --ref refs/pull/42/head, then the results appear as alerts in a pull request check. For more information, see \"Triaging code scanning alerts in pull requests.\"
\n
If you upload to a branch, for example --ref refs/heads/my-branch, then the results appear in the Security tab for your repository. For more information, see \"Managing code scanning alerts for your repository.\"
\n
\n
You must compress the SARIF-formatted analysis data that you want to upload, using gzip, and then encode it as a Base64 format string. For example:
\n
gzip -c analysis-data.sarif | base64\n
\n
SARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.
\n
The 202 Accepted, response includes an id value.\nYou can use this ID to check the status of the upload by using this for the /sarifs/{sarif_id} endpoint.\nFor more information, see \"Get information about a SARIF upload.\"
",
"bodyParameters": [
{
"description": "
Required. The SHA of the commit to which the analysis you are uploading relates.
"
}
],
"x-codeSamples": [
@@ -65459,7 +65812,7 @@
}
],
"summary": "Create a repository using a template",
- "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/github-ae@latest/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository using a repository template. Use the `template_owner` and `template_repo` route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the [Get a repository](https://docs.github.com/github-ae@latest/rest/reference/repos#get-a-repository) endpoint and check that the `is_template` key is `true`.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository",
"tags": [
"repos"
],
@@ -65554,7 +65907,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository
\n
repo scope to create a private repository
\n
",
+ "descriptionHTML": "
Creates a new repository using a repository template. Use the template_owner and template_repo route parameters to specify the repository to use as the template. The authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the Get a repository endpoint and check that the is_template key is true.
public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.
\n
repo scope to create a private repository
\n
",
"bodyParameters": [
{
"type": "string",
@@ -65642,7 +65995,7 @@
}
],
"summary": "List public repositories",
- "description": "Lists all public repositories in the order that they were created.\n\nNote: Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
+ "description": "Lists all public repositories in the order that they were created.\n\nNotes:\n- For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.\n- Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#link-header) to get the URL for the next page of repositories.",
"tags": [
"repos"
],
@@ -65663,7 +66016,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
",
+ "descriptionHTML": "
Lists all public repositories in the order that they were created.
\n
Notes:
\n
\n
For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise.
\n
Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.
Deletes a secret in an environment using the secret name. You must authenticate using an access token with the repo scope to use this endpoint. GitHub Apps must have the secrets repository permission to use this endpoint.
"
},
+ {
+ "verb": "get",
+ "requestPath": "/scim/v2/enterprises/{enterprise}/Groups",
+ "serverUrl": "https://api.github.com",
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "descriptionHTML": "
The slug version of the enterprise name. You can also substitute this value with the enterprise id.
"
+ },
+ {
+ "name": "startIndex",
+ "description": "Used for pagination: the index of the first result to return.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ },
+ "descriptionHTML": "
Used for pagination: the index of the first result to return.
"
+ },
+ {
+ "name": "count",
+ "description": "Used for pagination: the number of results to return.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ },
+ "descriptionHTML": "
Used for pagination: the number of results to return.
"
+ }
+ ],
+ "summary": "Provision a SCIM enterprise group and invite users",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nProvision an enterprise group, and invite users to the group. This sends invitation emails to the email address of the invited users to join the GitHub organization that the SCIM group corresponds to.",
+ "operationId": "enterprise-admin/provision-and-invite-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#provision-a-scim-enterprise-group-and-invite-users"
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array of strings",
+ "description": "
Required. The name of the SCIM group. This must match the GitHub organization that the group maps to.
",
+ "name": "displayName",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The name of the SCIM group. This must match the GitHub organization that the group maps to.",
+ "childParamsGroups": []
+ },
+ "members": {
+ "type": "array of objects",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "
Required. The SCIM user ID for a user.
",
+ "name": "value",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The SCIM user ID for a user.",
+ "childParamsGroups": []
+ }
+ },
+ "required": [
+ "value"
+ ]
+ },
+ "name": "members",
+ "in": "body",
+ "rawType": "array",
+ "description": "
Note: The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.
\n
Provision an enterprise group, and invite users to the group. This sends invitation emails to the email address of the invited users to join the GitHub organization that the SCIM group corresponds to.
Required. The name of the SCIM group. This must match the GitHub organization that the group maps to.
",
+ "name": "displayName",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The name of the SCIM group. This must match the GitHub organization that the group maps to.",
+ "childParamsGroups": []
+ },
+ {
+ "type": "array of objects",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "
Required. The SCIM user ID for a user.
",
+ "name": "value",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The SCIM user ID for a user.",
+ "childParamsGroups": []
+ }
+ },
+ "required": [
+ "value"
+ ]
+ },
+ "name": "members",
+ "in": "body",
+ "rawType": "array",
+ "description": "
"
+ }
+ ],
+ "summary": "Set SCIM information for a provisioned enterprise group",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nReplaces an existing provisioned group’s information. You must provide all the information required for the group as if you were provisioning it for the first time. Any existing group information that you don't provide will be removed, including group membership. If you want to only update a specific attribute, use the [Update an attribute for a SCIM enterprise group](#update-an-attribute-for-a-scim-enterprise-group) endpoint instead.",
+ "operationId": "enterprise-admin/set-information-for-provisioned-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#set-scim-information-for-a-provisioned-enterprise-group"
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array of strings",
+ "description": "
Required. The name of the SCIM group. This must match the GitHub organization that the group maps to.
",
+ "name": "displayName",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The name of the SCIM group. This must match the GitHub organization that the group maps to.",
+ "childParamsGroups": []
+ },
+ "members": {
+ "type": "array of objects",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "
Required. The SCIM user ID for a user.
",
+ "name": "value",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The SCIM user ID for a user.",
+ "childParamsGroups": []
+ }
+ },
+ "required": [
+ "value"
+ ]
+ },
+ "name": "members",
+ "in": "body",
+ "rawType": "array",
+ "description": "
Note: The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.
\n
Replaces an existing provisioned group’s information. You must provide all the information required for the group as if you were provisioning it for the first time. Any existing group information that you don't provide will be removed, including group membership. If you want to only update a specific attribute, use the Update an attribute for a SCIM enterprise group endpoint instead.
Required. The name of the SCIM group. This must match the GitHub organization that the group maps to.
",
+ "name": "displayName",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The name of the SCIM group. This must match the GitHub organization that the group maps to.",
+ "childParamsGroups": []
+ },
+ {
+ "type": "array of objects",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "
Required. The SCIM user ID for a user.
",
+ "name": "value",
+ "in": "body",
+ "rawType": "string",
+ "rawDescription": "The SCIM user ID for a user.",
+ "childParamsGroups": []
+ }
+ },
+ "required": [
+ "value"
+ ]
+ },
+ "name": "members",
+ "in": "body",
+ "rawType": "array",
+ "description": "
"
+ }
+ ],
+ "summary": "Update an attribute for a SCIM enterprise group",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nAllows you to change a provisioned group’s individual attributes. To change a group’s values, you must provide a specific Operations JSON format that contains at least one of the add, remove, or replace operations. For examples and more information on the SCIM operations format, see the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).",
+ "operationId": "enterprise-admin/update-attribute-for-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#update-an-attribute-for-a-scim-enterprise-group"
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array of strings",
+ "description": "
Note: The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.
\n
Allows you to change a provisioned group’s individual attributes. To change a group’s values, you must provide a specific Operations JSON format that contains at least one of the add, remove, or replace operations. For examples and more information on the SCIM operations format, see the SCIM specification.
"
+ }
+ ],
+ "summary": "Delete a SCIM group from an enterprise",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.",
+ "operationId": "enterprise-admin/delete-scim-group-from-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#delete-a-scim-group-from-an-enterprise"
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ },
+ "slug": "delete-a-scim-group-from-an-enterprise",
+ "category": "enterprise-admin",
+ "categoryLabel": "Enterprise admin",
+ "subcategory": "scim",
+ "subcategoryLabel": "Scim",
+ "notes": [],
+ "responses": [
+ {
+ "httpStatusCode": "204",
+ "httpStatusMessage": "No Content",
+ "description": "Default Response"
+ }
+ ],
+ "bodyParameters": [],
+ "descriptionHTML": "
Note: The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.
"
+ },
{
"verb": "get",
"requestPath": "/search/code",
@@ -71950,6 +73348,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -73016,7 +74415,7 @@
"parameters": [
{
"name": "visibility",
- "description": "Can be one of `all`, `public`, or `private`.",
+ "description": "Can be one of `all`, `public`, or `private`. Note: For GitHub AE, can be one of `all`, `internal`, or `private`.",
"in": "query",
"required": false,
"schema": {
@@ -73028,7 +74427,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, public, or private.
"
+ "descriptionHTML": "
Can be one of all, public, or private. Note: For GitHub AE, can be one of all, internal, or private.
"
},
{
"name": "affiliation",
@@ -73043,7 +74442,7 @@
},
{
"name": "type",
- "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
+ "description": "Can be one of `all`, `owner`, `public`, `private`, `member`. Note: For GitHub AE, can be one of `all`, `owner`, `internal`, `private`, `member`. Default: `all` \n \nWill cause a `422` error if used in the same request as **visibility** or **affiliation**. Will cause a `422` error if used in the same request as **visibility** or **affiliation**.",
"in": "query",
"required": false,
"schema": {
@@ -73057,7 +74456,7 @@
],
"default": "all"
},
- "descriptionHTML": "
Can be one of all, owner, public, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
+ "descriptionHTML": "
Can be one of all, owner, public, private, member. Note: For GitHub AE, can be one of all, owner, internal, private, member. Default: all
\n
Will cause a 422 error if used in the same request as visibility or affiliation. Will cause a 422 error if used in the same request as visibility or affiliation.
"
},
{
"name": "sort",
@@ -73213,7 +74612,7 @@
}
],
"summary": "Create a repository for the authenticated user",
- "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository\n* `repo` scope to create a private repository",
+ "description": "Creates a new repository for the authenticated user.\n\n**OAuth scope requirements**\n\nWhen using [OAuth](https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), authorizations must include:\n\n* `public_repo` scope or `repo` scope to create a public repository. Note: For GitHub AE, use `repo` scope to create an internal repository.\n* `repo` scope to create a private repository.",
"tags": [
"repos"
],
@@ -73256,13 +74655,13 @@
"childParamsGroups": []
},
"private": {
- "description": "
Whether the repository is private or public.
",
+ "description": "
Whether the repository is private.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
"has_issues": {
@@ -73436,7 +74835,7 @@
"category": "repos",
"categoryLabel": "Repos",
"notes": [],
- "descriptionHTML": "
Creates a new repository for the authenticated user.
",
"default": false,
"type": "boolean",
"name": "private",
"in": "body",
"rawType": "boolean",
- "rawDescription": "Whether the repository is private or public.",
+ "rawDescription": "Whether the repository is private.",
"childParamsGroups": []
},
{
@@ -75950,7 +77349,7 @@
}
],
"summary": "List repositories for a user",
- "description": "Lists public repositories for the specified user.",
+ "description": "Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.",
"tags": [
"repos"
],
@@ -75978,7 +77377,7 @@
"categoryLabel": "Repos",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
Lists public repositories for the specified user.
",
+ "descriptionHTML": "
Lists public repositories for the specified user. Note: For GitHub AE, this endpoint will list internal repositories for the specified user.
",
"responses": [
{
"httpStatusCode": "200",
diff --git a/lib/rest/static/dereferenced/api.github.com.deref.json b/lib/rest/static/dereferenced/api.github.com.deref.json
index 290e985a82..22e6099f63 100644
--- a/lib/rest/static/dereferenced/api.github.com.deref.json
+++ b/lib/rest/static/dereferenced/api.github.com.deref.json
@@ -4257,6 +4257,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -9931,6 +9940,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -21390,6 +21408,15 @@
]
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
{
"name": "per_page",
"description": "Results per page (max 100).",
@@ -32289,6 +32316,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -34988,6 +35016,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -48089,6 +48126,24 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -52926,6 +52981,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -54793,6 +54866,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -62526,6 +62608,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -66590,6 +66673,22 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "exclude",
+ "description": "Exclude attributes from the API response to improve performance",
+ "in": "query",
+ "schema": {
+ "type": "array",
+ "items": {
+ "description": "Allowed values that can be passed to the exclude param.",
+ "enum": [
+ "repositories"
+ ],
+ "example": "repositories",
+ "type": "string"
+ }
+ }
}
],
"responses": {
@@ -69444,6 +69543,22 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "exclude",
+ "description": "Exclude attributes from the API response to improve performance",
+ "in": "query",
+ "schema": {
+ "type": "array",
+ "items": {
+ "description": "Allowed values that can be passed to the exclude param.",
+ "enum": [
+ "repositories"
+ ],
+ "example": "repositories",
+ "type": "string"
+ }
+ }
}
],
"responses": {
@@ -75183,6 +75298,15 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "token",
+ "description": "package token",
+ "schema": {
+ "type": "string"
+ },
+ "required": false,
+ "in": "query"
}
],
"responses": {
@@ -75268,7 +75392,7 @@
"tags": [
"packages"
],
- "operationId": "packages/get-all-package-versions-for-a-package-owned-by-an-org",
+ "operationId": "packages/get-all-package-versions-for-package-owned-by-org",
"externalDocs": {
"description": "API method documentation",
"url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
@@ -75307,6 +75431,38 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "state",
+ "in": "query",
+ "required": false,
+ "description": "The state of the package, either active or deleted.",
+ "schema": {
+ "type": "string",
+ "enum": [
+ "active",
+ "deleted"
+ ],
+ "default": "active"
+ }
}
],
"responses": {
@@ -80346,7 +80502,7 @@
"/orgs/{org}/settings/billing/actions": {
"get": {
"summary": "Get GitHub Actions billing for an organization",
- "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `repo` or `admin:org` scope.",
+ "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `repo` or `admin:org` scope.",
"operationId": "billing/get-github-actions-billing-org",
"tags": [
"billing"
@@ -80617,11 +80773,10 @@
},
{
"name": "page",
- "description": "Page number of the results to fetch.",
+ "description": "Page token",
"in": "query",
"schema": {
- "type": "integer",
- "default": 1
+ "type": "string"
}
}
],
@@ -82899,6 +83054,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "pinned",
+ "in": "query",
+ "required": false,
+ "description": "Pinned discussions only filter",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -150229,7 +150393,7 @@
"/repos/{owner}/{repo}/code-scanning/alerts": {
"get": {
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -150301,7 +150465,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -150314,6 +150478,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -150369,6 +150534,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -150564,7 +150730,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -150579,6 +150745,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -150926,6 +151093,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -151136,7 +151304,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -151151,6 +151319,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -151502,6 +151671,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -151712,7 +151882,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -151727,6 +151897,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -152011,7 +152182,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
}
],
@@ -152027,7 +152198,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -152042,6 +152213,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -152296,7 +152468,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -152324,7 +152496,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -152585,7 +152757,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -152818,7 +152990,8 @@
"description": "Allow deletion if the specified analysis is the last in a set. The parameter can be used without a value as the parameter value is not considered. If you attempt to delete the final analysis in a set without using this parameter you'll get a 400 response with the message: `Analysis is last of its type and deletion may result in the loss of historical alert data. Please specify confirm_delete.`",
"required": false,
"schema": {
- "type": "string"
+ "type": "string",
+ "nullable": true
}
}
],
@@ -152993,7 +153166,7 @@
"/repos/{owner}/{repo}/code-scanning/sarifs": {
"post": {
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -153035,7 +153208,7 @@
},
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"sarif": {
"description": "A Base64 string representing the SARIF file to upload. You must first compress your SARIF file using [`gzip`](http://www.gnu.org/software/gzip/manual/gzip.html) and then translate the contents of the file into a Base64 encoding string. For more information, see \"[SARIF support for code scanning](https://docs.github.com/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning).\"",
@@ -158253,6 +158426,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -164118,9 +164311,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -164865,7 +165076,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -164927,6 +165138,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -165914,7 +166133,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -168212,13 +168431,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -169980,7 +170217,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -172631,7 +172868,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -173346,7 +173583,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -174038,7 +174275,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -174761,7 +174998,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -183338,7 +183576,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -183360,6 +183599,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -185080,6 +185339,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -185087,6 +185366,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -187567,7 +187847,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -187729,7 +188009,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -188089,7 +188369,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -188304,7 +188584,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -189320,7 +189600,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -242315,16 +242596,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -262972,6 +263252,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -265459,7 +266012,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -271260,6 +271813,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -271574,6 +272145,7 @@
"schema": {
"type": "string",
"enum": [
+ "",
"day",
"week"
],
@@ -272078,6 +272650,7 @@
"schema": {
"type": "string",
"enum": [
+ "",
"day",
"week"
],
@@ -277009,6 +277582,24 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "filter",
+ "description": "filter results",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "excludedAttributes",
+ "description": "attributes to exclude",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -277396,6 +277987,15 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "excludedAttributes",
+ "description": "Attributes to exclude.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -277998,6 +278598,15 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "filter",
+ "description": "filter results",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -310308,6 +310917,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -324163,6 +324773,15 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "token",
+ "description": "package token",
+ "schema": {
+ "type": "string"
+ },
+ "required": false,
+ "in": "query"
}
],
"responses": {
@@ -324248,7 +324867,7 @@
"tags": [
"packages"
],
- "operationId": "packages/get-all-package-versions-for-a-package-owned-by-the-authenticated-user",
+ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user",
"externalDocs": {
"description": "API method documentation",
"url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
@@ -324279,6 +324898,38 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "state",
+ "in": "query",
+ "required": false,
+ "description": "The state of the package, either active or deleted.",
+ "schema": {
+ "type": "string",
+ "enum": [
+ "active",
+ "deleted"
+ ],
+ "default": "active"
+ }
}
],
"responses": {
@@ -356916,7 +357567,7 @@
"/users/{username}/settings/billing/actions": {
"get": {
"summary": "Get GitHub Actions billing for a user",
- "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `user` scope.",
+ "description": "Gets the summary of the free and paid GitHub Actions minutes used.\n\nPaid minutes only apply to workflows in private repositories that use GitHub-hosted runners. Minutes used is listed for each GitHub-hosted runner operating system. Any job re-runs are also included in the usage. The usage returned includes any minute multipliers for macOS and Windows runners, and is rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nAccess tokens must have the `user` scope.",
"operationId": "billing/get-github-actions-billing-user",
"tags": [
"billing"
diff --git a/lib/rest/static/dereferenced/ghes-2.18.deref.json b/lib/rest/static/dereferenced/ghes-2.18.deref.json
index 11b1bbf946..b30da5d436 100644
--- a/lib/rest/static/dereferenced/ghes-2.18.deref.json
+++ b/lib/rest/static/dereferenced/ghes-2.18.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1899,6 +1936,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2744,6 +2809,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -8911,6 +9005,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -10508,6 +10611,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -28017,6 +28129,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -30679,6 +30792,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -43615,6 +43737,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -48038,6 +48161,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -94486,6 +94638,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -100147,9 +100319,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -100894,7 +101084,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -100956,6 +101146,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -101937,7 +102135,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -104189,13 +104387,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -105934,7 +106150,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -108169,7 +108385,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -108884,7 +109100,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -109576,7 +109792,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -110299,7 +110515,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -116955,7 +117172,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -116977,6 +117195,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -118673,6 +118911,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -118680,6 +118938,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -121476,7 +121735,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -121691,7 +121950,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -122707,7 +122966,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -164648,6 +164908,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -173085,16 +173373,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -192567,6 +192854,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@2.18/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@2.18/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -195054,7 +195614,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -199871,6 +200431,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -234335,6 +234913,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/ghes-2.19.deref.json b/lib/rest/static/dereferenced/ghes-2.19.deref.json
index 5206af05c2..42599cedf7 100644
--- a/lib/rest/static/dereferenced/ghes-2.19.deref.json
+++ b/lib/rest/static/dereferenced/ghes-2.19.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1899,6 +1936,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2746,6 +2811,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -8925,6 +9019,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -10528,6 +10631,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -28047,6 +28159,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -30714,6 +30827,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -44253,6 +44375,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -48681,6 +48804,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -97468,6 +97620,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -103129,9 +103301,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -103876,7 +104066,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -103938,6 +104128,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -104929,7 +105127,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -107186,13 +107384,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -108931,7 +109147,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -111166,7 +111382,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -111881,7 +112097,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -112573,7 +112789,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -113296,7 +113512,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -119992,7 +120209,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -120014,6 +120232,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -121710,6 +121948,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -121717,6 +121975,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -124176,7 +124435,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -124338,7 +124597,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -124698,7 +124957,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -124913,7 +125172,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -125929,7 +126188,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -168072,6 +168332,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -176509,16 +176797,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -195991,6 +196278,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@2.19/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@2.19/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -198478,7 +199038,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -203295,6 +203855,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -237584,6 +238162,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/ghes-2.20.deref.json b/lib/rest/static/dereferenced/ghes-2.20.deref.json
index 9c8e315069..a5df8416c8 100644
--- a/lib/rest/static/dereferenced/ghes-2.20.deref.json
+++ b/lib/rest/static/dereferenced/ghes-2.20.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1895,6 +1932,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2742,6 +2807,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -8930,6 +9024,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -13439,6 +13542,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -31006,6 +31118,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -33682,6 +33795,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -47281,6 +47403,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -51718,6 +51841,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -99621,6 +99773,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -105300,9 +105472,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -106047,7 +106237,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -106109,6 +106299,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -107100,7 +107298,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -109369,13 +109567,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -111125,7 +111341,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -113360,7 +113576,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -114075,7 +114291,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -114767,7 +114983,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -115490,7 +115706,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -122194,7 +122411,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -122216,6 +122434,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -123924,6 +124162,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -123931,6 +124189,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -126399,7 +126658,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -126561,7 +126820,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -126921,7 +127180,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -127136,7 +127395,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -128152,7 +128411,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -170392,6 +170652,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -178847,16 +179135,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -198980,6 +199267,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@2.20/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@2.20/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -201467,7 +202027,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -206284,6 +206844,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -240653,6 +241231,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/ghes-2.21.deref.json b/lib/rest/static/dereferenced/ghes-2.21.deref.json
index 8aaab6d84b..a6998a1b0d 100644
--- a/lib/rest/static/dereferenced/ghes-2.21.deref.json
+++ b/lib/rest/static/dereferenced/ghes-2.21.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1895,6 +1932,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2742,6 +2807,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -8935,6 +9029,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -13444,6 +13547,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -31030,6 +31142,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -33716,6 +33829,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -47357,6 +47479,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -51804,6 +51927,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -58520,6 +58672,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "pinned",
+ "in": "query",
+ "required": false,
+ "description": "Pinned discussions only filter",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -110569,6 +110730,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -116268,9 +116449,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -117015,7 +117214,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -117077,6 +117276,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -118068,7 +118275,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -120350,13 +120557,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -122118,7 +122343,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -124353,7 +124578,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -125068,7 +125293,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -125760,7 +125985,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -126483,7 +126708,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -133444,7 +133670,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -133466,6 +133693,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -135187,6 +135434,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -135194,6 +135461,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -137672,7 +137940,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -137834,7 +138102,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -138194,7 +138462,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -138409,7 +138677,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -139425,7 +139693,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -181907,6 +182176,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -190372,16 +190669,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -210589,6 +210885,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@2.21/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@2.21/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -213076,7 +213645,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -217893,6 +218462,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -249642,6 +250229,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/ghes-2.22.deref.json b/lib/rest/static/dereferenced/ghes-2.22.deref.json
index a5ca44119e..ebf7fa61ea 100644
--- a/lib/rest/static/dereferenced/ghes-2.22.deref.json
+++ b/lib/rest/static/dereferenced/ghes-2.22.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1899,6 +1936,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2746,6 +2811,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -9028,6 +9122,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -13534,6 +13637,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -34838,6 +34950,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -37537,6 +37650,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -46801,6 +46923,24 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -51412,6 +51552,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -58187,6 +58345,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -62647,6 +62806,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -69501,6 +69689,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "pinned",
+ "in": "query",
+ "required": false,
+ "description": "Pinned discussions only filter",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -132525,7 +132722,7 @@
"/repos/{owner}/{repo}/code-scanning/alerts": {
"get": {
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -132597,7 +132794,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -132610,6 +132807,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -132665,6 +132863,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -132860,7 +133059,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -132875,6 +133074,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -133222,6 +133422,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -133432,7 +133633,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -133447,6 +133648,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -133798,6 +134000,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -134008,7 +134211,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -134023,6 +134226,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -134316,7 +134520,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -134344,7 +134548,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -134559,7 +134763,7 @@
"/repos/{owner}/{repo}/code-scanning/sarifs": {
"post": {
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -134601,7 +134805,7 @@
},
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"sarif": {
"description": "A Base64 string representing the SARIF file to upload. You must first compress your SARIF file using [`gzip`](http://www.gnu.org/software/gzip/manual/gzip.html) and then translate the contents of the file into a Base64 encoding string. For more information, see \"[SARIF support for code scanning](https://docs.github.com/enterprise-server@2.22/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning).\"",
@@ -139688,6 +139892,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -145408,9 +145632,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -146155,7 +146397,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -146217,6 +146459,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -147208,7 +147458,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -149510,13 +149760,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -151278,7 +151546,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -153513,7 +153781,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -154228,7 +154496,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -154920,7 +155188,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -155643,7 +155911,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -162594,7 +162863,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -162616,6 +162886,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -164336,6 +164626,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -164343,6 +164653,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -166823,7 +167134,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -166985,7 +167296,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -167345,7 +167656,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -167560,7 +167871,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -168576,7 +168887,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -211024,6 +211336,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -219506,16 +219846,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -239728,6 +240067,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@2.22/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@2.22/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -242215,7 +242827,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -247032,6 +247644,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -278885,6 +279515,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/ghes-3.0.deref.json b/lib/rest/static/dereferenced/ghes-3.0.deref.json
index 663a6c26ed..2fff74101d 100644
--- a/lib/rest/static/dereferenced/ghes-3.0.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.0.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1899,6 +1936,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -2746,6 +2811,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to) or `name`.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -9242,6 +9336,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -14916,6 +15019,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "client_id",
+ "in": "query",
+ "required": false,
+ "description": "The client ID of your GitHub app.",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -37262,6 +37374,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -39961,6 +40074,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -50858,6 +50980,24 @@
"schema": {
"type": "integer"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -55695,6 +55835,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -62720,6 +62878,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -67180,6 +67339,35 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "description": "The sort order for the response collection.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -74034,6 +74222,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "pinned",
+ "in": "query",
+ "required": false,
+ "description": "Pinned discussions only filter",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -137615,7 +137812,7 @@
"/repos/{owner}/{repo}/code-scanning/alerts": {
"get": {
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -137687,7 +137884,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -137700,6 +137897,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -137755,6 +137953,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -137950,7 +138149,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -137965,6 +138164,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -138312,6 +138512,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -138522,7 +138723,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -138537,6 +138738,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -138888,6 +139090,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -139098,7 +139301,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -139113,6 +139316,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -139406,7 +139610,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -139434,7 +139638,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -139649,7 +139853,7 @@
"/repos/{owner}/{repo}/code-scanning/sarifs": {
"post": {
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -139691,7 +139895,7 @@
},
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"sarif": {
"description": "A Base64 string representing the SARIF file to upload. You must first compress your SARIF file using [`gzip`](http://www.gnu.org/software/gzip/manual/gzip.html) and then translate the contents of the file into a Base64 encoding string. For more information, see \"[SARIF support for code scanning](https://docs.github.com/enterprise-server@3.0/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning).\"",
@@ -144778,6 +144982,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -150498,9 +150722,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -151245,7 +151487,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -151307,6 +151549,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -152294,7 +152544,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -154592,13 +154842,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -156360,7 +156628,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -158595,7 +158863,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -159310,7 +159578,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -160002,7 +160270,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -160725,7 +160993,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -167676,7 +167945,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -167698,6 +167968,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -169418,6 +169708,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -169425,6 +169735,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -171905,7 +172216,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -172067,7 +172378,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -172427,7 +172738,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -172642,7 +172953,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -173658,7 +173969,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -216353,6 +216665,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -224835,16 +225175,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -245057,6 +245396,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/enterprise-server@3.0/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/enterprise-server@3.0/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -247544,7 +248156,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -252361,6 +252973,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -284238,6 +284868,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/rest/static/dereferenced/github.ae.deref.json b/lib/rest/static/dereferenced/github.ae.deref.json
index 4fb966764a..c8fe35b941 100644
--- a/lib/rest/static/dereferenced/github.ae.deref.json
+++ b/lib/rest/static/dereferenced/github.ae.deref.json
@@ -1140,6 +1140,43 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "accessed"
+ ],
+ "default": "created"
+ }
+ },
+ {
+ "name": "since",
+ "description": "Only show public keys accessed after the given time.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -1519,6 +1556,34 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "direction",
+ "description": "One of `asc` (ascending) or `desc` (descending).",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "asc",
+ "desc"
+ ],
+ "default": "desc"
+ }
+ },
+ {
+ "name": "sort",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "enum": [
+ "created",
+ "updated",
+ "name"
+ ],
+ "default": "created"
+ }
}
],
"responses": {
@@ -25369,6 +25434,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -28068,6 +28134,15 @@
"type": "integer",
"default": 30
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -39355,6 +39430,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -46380,6 +46473,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
@@ -57323,6 +57417,15 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "pinned",
+ "in": "query",
+ "required": false,
+ "description": "Pinned discussions only filter",
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -120070,7 +120173,7 @@
"/repos/{owner}/{repo}/code-scanning/alerts": {
"get": {
"summary": "List code scanning alerts for a repository",
- "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+ "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint. GitHub Apps must have the `security_events` read permission to use\nthis endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
"tags": [
"code-scanning"
],
@@ -120142,7 +120245,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -120155,6 +120258,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -120210,6 +120314,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -120405,7 +120510,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -120420,6 +120525,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -120767,6 +120873,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -120977,7 +121084,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -120992,6 +121099,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -121343,6 +121451,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -121553,7 +121662,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -121568,6 +121677,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -121852,7 +121962,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
}
],
@@ -121868,7 +121978,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"analysis_key": {
"type": "string",
@@ -121883,6 +121993,7 @@
"description": "State of a code scanning alert.",
"enum": [
"open",
+ "closed",
"dismissed",
"fixed"
]
@@ -122137,7 +122248,7 @@
"required": false,
"schema": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
}
},
{
@@ -122165,7 +122276,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -122426,7 +122537,7 @@
"properties": {
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"commit_sha": {
"description": "The SHA of the commit to which the analysis you are uploading relates.",
@@ -122620,7 +122731,7 @@
"/repos/{owner}/{repo}/code-scanning/sarifs": {
"post": {
"summary": "Upload an analysis as SARIF data",
- "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
+ "description": "Uploads SARIF data containing the results of a code scanning analysis to make the results available in a repository. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.\n\nThere are two places where you can upload code scanning results.\n - If you upload to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see \"[Triaging code scanning alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests).\"\n - If you upload to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see \"[Managing code scanning alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository).\"\n\nYou must compress the SARIF-formatted analysis data that you want to upload, using `gzip`, and then encode it as a Base64 format string. For example:\n\n```\ngzip -c analysis-data.sarif | base64\n```\n\nSARIF upload supports a maximum of 1000 results per analysis run. Any results over this limit are ignored. Typically, but not necessarily, a SARIF file contains a single run of a single tool. If a code scanning tool generates too many results, you should update the analysis configuration to run only the most important rules or queries.\n\nThe `202 Accepted`, response includes an `id` value.\nYou can use this ID to check the status of the upload by using this for the `/sarifs/{sarif_id}` endpoint.\nFor more information, see \"[Get information about a SARIF upload](/rest/reference/code-scanning#get-information-about-a-sarif-upload).\"",
"operationId": "code-scanning/upload-sarif",
"tags": [
"code-scanning"
@@ -122662,7 +122773,7 @@
},
"ref": {
"type": "string",
- "description": "The full Git reference, formatted as `refs/heads/`."
+ "description": "The full Git reference, formatted as `refs/heads/`,\n`refs/pull//merge`, or `refs/pull//head`."
},
"sarif": {
"description": "A Base64 string representing the SARIF file to upload. You must first compress your SARIF file using [`gzip`](http://www.gnu.org/software/gzip/manual/gzip.html) and then translate the contents of the file into a Base64 encoding string. For more information, see \"[SARIF support for code scanning](https://docs.github.com/github-ae@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning).\"",
@@ -127880,6 +127991,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "top",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "last_sha",
+ "description": "legacy parameter for pagination.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -133745,9 +133876,27 @@
"type": "string"
}
},
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -134492,7 +134641,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -134554,6 +134703,14 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "app_id",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
}
],
"responses": {
@@ -135541,7 +135698,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -137839,13 +137996,31 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"x-multi-segment": true
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
}
],
"responses": {
@@ -139607,7 +139782,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -141842,7 +142017,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -142557,7 +142732,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -143249,7 +143424,7 @@
},
{
"name": "path",
- "description": "path+ parameter",
+ "description": "path parameter",
"in": "path",
"required": true,
"schema": {
@@ -143972,7 +144147,8 @@
"required": false,
"schema": {
"type": "string",
- "default": "none"
+ "default": "none",
+ "nullable": true
}
},
{
@@ -152404,7 +152580,8 @@
"enum": [
"newest",
"oldest",
- "stargazers"
+ "stargazers",
+ "watchers"
],
"default": "newest"
}
@@ -152426,6 +152603,26 @@
"type": "integer",
"default": 1
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"responses": {
@@ -154146,6 +154343,26 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "org",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "organization",
+ "description": "legacy query parameter for specifying the org.",
+ "in": "query",
+ "deprecated": true,
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
}
],
"requestBody": {
@@ -154153,6 +154370,7 @@
"application/json": {
"schema": {
"type": "object",
+ "nullable": true,
"properties": {
"organization": {
"type": "string",
@@ -156633,7 +156851,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -156795,7 +157013,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -157155,7 +157373,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -157370,7 +157588,7 @@
},
{
"name": "ref",
- "description": "ref+ parameter",
+ "description": "ref parameter",
"in": "path",
"required": true,
"schema": {
@@ -158386,7 +158604,8 @@
"required": true,
"schema": {
"type": "string"
- }
+ },
+ "x-multi-segment": true
},
{
"name": "recursive",
@@ -209468,16 +209687,15 @@
},
{
"name": "sort",
- "description": "One of `created` (when the repository was starred) or `updated` (when it was last pushed to).",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"created",
- "updated"
- ],
- "default": "created"
+ "updated",
+ "created_at"
+ ]
}
},
{
@@ -230125,6 +230343,279 @@
}
}
},
+ "/repos/{owner}/{repo}/readme/{dir}": {
+ "get": {
+ "summary": "Get a repository README",
+ "description": "Gets the preferred README for a repository.\n\nREADMEs support [custom media types](https://docs.github.com/github-ae@latest/rest/reference/repos#custom-media-types) for retrieving the raw content or rendered HTML.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/get-readme-from-alt-path",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/repos#get-a-repository-readme"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "dir",
+ "description": "The alternate path to look for a README file",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "x-multi-segment": true
+ },
+ {
+ "name": "ref",
+ "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually `master`)",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Content File",
+ "description": "Content File",
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "encoding": {
+ "type": "string"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "content": {
+ "type": "string"
+ },
+ "sha": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "git_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "download_url": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "_links": {
+ "type": "object",
+ "properties": {
+ "git": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "html": {
+ "type": "string",
+ "format": "uri",
+ "nullable": true
+ },
+ "self": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "git",
+ "html",
+ "self"
+ ]
+ },
+ "target": {
+ "type": "string",
+ "example": "\"actual/actual.md\""
+ },
+ "submodule_git_url": {
+ "type": "string",
+ "example": "\"git://example.com/defunkt/dotjs.git\""
+ }
+ },
+ "required": [
+ "_links",
+ "git_url",
+ "html_url",
+ "download_url",
+ "name",
+ "path",
+ "sha",
+ "size",
+ "type",
+ "url",
+ "content",
+ "encoding"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 5362,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "encoded content ...",
+ "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
+ "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
+ "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
+ "_links": {
+ "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
+ "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
+ "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Resource Not Found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Basic Error",
+ "description": "Basic Error",
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "422": {
+ "description": "Validation Failed",
+ "content": {
+ "application/json": {
+ "schema": {
+ "title": "Validation Error",
+ "description": "Validation Error",
+ "type": "object",
+ "required": [
+ "message",
+ "documentation_url"
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "documentation_url": {
+ "type": "string"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "code"
+ ],
+ "properties": {
+ "resource": {
+ "type": "string"
+ },
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "index": {
+ "type": "integer"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string",
+ "nullable": true
+ },
+ {
+ "type": "integer",
+ "nullable": true
+ },
+ {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [
+
+ ],
+ "category": "repos",
+ "subcategory": "contents"
+ }
+ }
+ },
"/repos/{owner}/{repo}/releases": {
"get": {
"summary": "List releases",
@@ -232612,7 +233103,7 @@
},
{
"name": "tag",
- "description": "tag+ parameter",
+ "description": "tag parameter",
"in": "path",
"required": true,
"schema": {
@@ -237429,6 +237920,24 @@
"schema": {
"type": "string"
}
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100).",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
}
],
"responses": {
@@ -242371,6 +242880,1022 @@
}
}
},
+ "/scim/v2/enterprises/{enterprise}/Groups": {
+ "get": {
+ "summary": "List provisioned SCIM groups for an enterprise",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.",
+ "operationId": "enterprise-admin/list-provisioned-groups-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#list-provisioned-scim-groups-for-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "startIndex",
+ "description": "Used for pagination: the index of the first result to return.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "count",
+ "description": "Used for pagination: the number of results to return.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "filter",
+ "description": "filter results",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "excludedAttributes",
+ "description": "attributes to exclude",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "totalResults": {
+ "type": "number"
+ },
+ "itemsPerPage": {
+ "type": "number"
+ },
+ "startIndex": {
+ "type": "number"
+ },
+ "Resources": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "id": {
+ "type": "string"
+ },
+ "externalId": {
+ "type": "string",
+ "nullable": true
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "$ref": {
+ "type": "string"
+ },
+ "display": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "meta": {
+ "type": "object",
+ "properties": {
+ "resourceType": {
+ "type": "string"
+ },
+ "created": {
+ "type": "string"
+ },
+ "lastModified": {
+ "type": "string"
+ },
+ "location": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "id"
+ ]
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "totalResults",
+ "itemsPerPage",
+ "startIndex",
+ "Resources"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "schemas": [
+ "urn:ietf:params:scim:api:messages:2.0:ListResponse"
+ ],
+ "totalResults": 2,
+ "itemsPerPage": 2,
+ "startIndex": 1,
+ "Resources": [
+ {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "abcd27f8-a9aa-11ea-8221-f59b2be9cccc",
+ "externalId": null,
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "display": "hubot@example.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T03:10:17.000+10:00",
+ "lastModified": "2020-06-09T03:10:17.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/abcd27f8-a9aa-11ea-8221-f59b2be9cccc"
+ }
+ },
+ {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "5e75bbbb-aa1a-11ea-8644-75ff655cdddd",
+ "externalId": null,
+ "displayName": "octo-docs-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T16:28:01.000+10:00",
+ "lastModified": "2020-06-09T16:28:01.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/5e75bbbb-aa1a-11ea-8644-75ff655cdddd"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ },
+ "post": {
+ "summary": "Provision a SCIM enterprise group and invite users",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nProvision an enterprise group, and invite users to the group. This sends invitation emails to the email address of the invited users to join the GitHub organization that the SCIM group corresponds to.",
+ "operationId": "enterprise-admin/provision-and-invite-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#provision-a-scim-enterprise-group-and-invite-users"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "description": "The SCIM schema URIs.",
+ "items": {
+ "type": "string"
+ }
+ },
+ "displayName": {
+ "type": "string",
+ "description": "The name of the SCIM group. This must match the GitHub organization that the group maps to."
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "The SCIM user ID for a user."
+ }
+ },
+ "required": [
+ "value"
+ ]
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "displayName"
+ ]
+ },
+ "example": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5"
+ }
+ ]
+ }
+ }
+ }
+ },
+ "responses": {
+ "201": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "id": {
+ "type": "string"
+ },
+ "externalId": {
+ "type": "string",
+ "nullable": true
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "$ref": {
+ "type": "string"
+ },
+ "display": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "meta": {
+ "type": "object",
+ "properties": {
+ "resourceType": {
+ "type": "string"
+ },
+ "created": {
+ "type": "string"
+ },
+ "lastModified": {
+ "type": "string"
+ },
+ "location": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "id"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "abcd27f8-a9aa-11ea-8221-f59b2be9cccc",
+ "externalId": null,
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "display": "hubot@example.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T03:10:17.000+10:0",
+ "lastModified": "2020-06-09T03:10:17.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/abcd27f8-a9aa-11ea-8221-f59b2be9cccc"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ }
+ },
+ "/scim/v2/enterprises/{enterprise}/Groups/{scim_group_id}": {
+ "get": {
+ "summary": "Get SCIM provisioning information for an enterprise group",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.",
+ "operationId": "enterprise-admin/get-provisioning-information-for-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#get-scim-provisioning-information-for-an-enterprise-group"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "scim_group_id",
+ "description": "Identifier generated by the GitHub SCIM endpoint.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "excludedAttributes",
+ "description": "Attributes to exclude.",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "id": {
+ "type": "string"
+ },
+ "externalId": {
+ "type": "string",
+ "nullable": true
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "$ref": {
+ "type": "string"
+ },
+ "display": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "meta": {
+ "type": "object",
+ "properties": {
+ "resourceType": {
+ "type": "string"
+ },
+ "created": {
+ "type": "string"
+ },
+ "lastModified": {
+ "type": "string"
+ },
+ "location": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "id"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "abcd27f8-a9aa-11ea-8221-f59b2be9cccc",
+ "externalId": null,
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "display": "hubot@example.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T03:10:17.000+10:0",
+ "lastModified": "2020-06-09T03:10:17.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/abcd27f8-a9aa-11ea-8221-f59b2be9cccc"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ },
+ "put": {
+ "summary": "Set SCIM information for a provisioned enterprise group",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nReplaces an existing provisioned group’s information. You must provide all the information required for the group as if you were provisioning it for the first time. Any existing group information that you don't provide will be removed, including group membership. If you want to only update a specific attribute, use the [Update an attribute for a SCIM enterprise group](#update-an-attribute-for-a-scim-enterprise-group) endpoint instead.",
+ "operationId": "enterprise-admin/set-information-for-provisioned-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#set-scim-information-for-a-provisioned-enterprise-group"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "scim_group_id",
+ "description": "Identifier generated by the GitHub SCIM endpoint.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "description": "The SCIM schema URIs.",
+ "items": {
+ "type": "string"
+ }
+ },
+ "displayName": {
+ "type": "string",
+ "description": "The name of the SCIM group. This must match the GitHub organization that the group maps to."
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string",
+ "description": "The SCIM user ID for a user."
+ }
+ },
+ "required": [
+ "value"
+ ]
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "displayName"
+ ]
+ },
+ "example": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5"
+ }
+ ]
+ }
+ }
+ }
+ },
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "id": {
+ "type": "string"
+ },
+ "externalId": {
+ "type": "string",
+ "nullable": true
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "$ref": {
+ "type": "string"
+ },
+ "display": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "meta": {
+ "type": "object",
+ "properties": {
+ "resourceType": {
+ "type": "string"
+ },
+ "created": {
+ "type": "string"
+ },
+ "lastModified": {
+ "type": "string"
+ },
+ "location": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "id"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "abcd27f8-a9aa-11ea-8221-f59b2be9cccc",
+ "externalId": null,
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ },
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5",
+ "display": "hubot@example.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T03:10:17.000+10:0",
+ "lastModified": "2020-06-09T03:10:17.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/abcd27f8-a9aa-11ea-8221-f59b2be9cccc"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ },
+ "patch": {
+ "summary": "Update an attribute for a SCIM enterprise group",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.\n\nAllows you to change a provisioned group’s individual attributes. To change a group’s values, you must provide a specific Operations JSON format that contains at least one of the add, remove, or replace operations. For examples and more information on the SCIM operations format, see the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).",
+ "operationId": "enterprise-admin/update-attribute-for-enterprise-group",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#update-an-attribute-for-a-scim-enterprise-group"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "scim_group_id",
+ "description": "Identifier generated by the GitHub SCIM endpoint.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "description": "The SCIM schema URIs.",
+ "items": {
+ "type": "string"
+ }
+ },
+ "Operations": {
+ "type": "array",
+ "description": "Array of [SCIM operations](https://tools.ietf.org/html/rfc7644#section-3.5.2).",
+ "minItems": 1,
+ "items": {
+ "type": "object",
+ "properties": {
+ "op": {
+ "type": "string",
+ "enum": [
+ "add",
+ "Add",
+ "remove",
+ "Remove",
+ "replace",
+ "Replace"
+ ]
+ },
+ "path": {
+ "type": "string"
+ },
+ "value": {
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ]
+ }
+ },
+ "required": [
+ "op"
+ ]
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "Operations"
+ ]
+ },
+ "example": {
+ "schemas": [
+ "urn:ietf:params:scim:api:messages:2.0:PatchOp"
+ ],
+ "Operations": [
+ {
+ "op": "remove",
+ "path": "members",
+ "value": [
+ {
+ "value": "aaaa8c34-a6b2-11ea-9d70-bbbbbd1c8fd5"
+ }
+ ]
+ }
+ ]
+ }
+ }
+ }
+ },
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "schemas": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "id": {
+ "type": "string"
+ },
+ "externalId": {
+ "type": "string",
+ "nullable": true
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "members": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "$ref": {
+ "type": "string"
+ },
+ "display": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "meta": {
+ "type": "object",
+ "properties": {
+ "resourceType": {
+ "type": "string"
+ },
+ "created": {
+ "type": "string"
+ },
+ "lastModified": {
+ "type": "string"
+ },
+ "location": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": [
+ "schemas",
+ "id"
+ ]
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "schemas": [
+ "urn:ietf:params:scim:schemas:core:2.0:Group"
+ ],
+ "id": "abcd27f8-a9aa-11ea-8221-f59b2be9cccc",
+ "externalId": null,
+ "displayName": "octo-org",
+ "members": [
+ {
+ "value": "92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "$ref": "https://api.github.com/scim/v2/enterprises/octo-corp/Users/92b58aaa-a1d6-11ea-8227-b9ce9e023ccc",
+ "display": "octocat@github.com"
+ }
+ ],
+ "meta": {
+ "resourceType": "Group",
+ "created": "2020-06-09T03:10:17.000+10:00",
+ "lastModified": "2020-06-09T03:10:17.000+10:00",
+ "location": "https://api.github.com/scim/v2/enterprises/octo-corp/Groups/abcd27f8-a9aa-11ea-8221-f59b2be9cccc"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ },
+ "delete": {
+ "summary": "Delete a SCIM group from an enterprise",
+ "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in beta and are subject to change.",
+ "operationId": "enterprise-admin/delete-scim-group-from-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/enterprise-admin#delete-a-scim-group-from-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "scim_group_id",
+ "description": "Identifier generated by the GitHub SCIM endpoint.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": true,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "scim"
+ }
+ }
+ },
"/search/code": {
"get": {
"summary": "Search code",
@@ -267853,6 +269378,7 @@
"created",
"mentioned",
"subscribed",
+ "repos",
"all"
],
"default": "assigned"
diff --git a/lib/schema-event.js b/lib/schema-event.js
index fbb37060f2..913cf1d9a3 100644
--- a/lib/schema-event.js
+++ b/lib/schema-event.js
@@ -73,7 +73,7 @@ const context = {
os: {
type: 'string',
description: 'The type of operating system the user is working with.',
- enum: ['windows', 'mac', 'linux', 'ios', 'android', 'other'],
+ enum: ['windows', 'mac', 'linux', 'ios', 'android', 'cros', 'other'],
default: 'other'
},
os_version: {
diff --git a/lib/search/algolia-search.js b/lib/search/algolia-search.js
index e14b4e4524..4f415a9c5c 100644
--- a/lib/search/algolia-search.js
+++ b/lib/search/algolia-search.js
@@ -6,7 +6,7 @@ const { namePrefix } = require('./config')
// This API key is public. There's also a private API key for writing to the Algolia API
const searchClient = algoliasearch('ZI5KPY1HBE', '685df617246c3a10abba589b4599288f')
-module.exports = async function loadAlgoliaResults ({ version, language, query, limit }) {
+module.exports = async function loadAlgoliaResults ({ version, language, query, filters, limit }) {
const indexName = `${namePrefix}-${version}-${language}`
const index = searchClient.initIndex(indexName)
@@ -16,7 +16,8 @@ module.exports = async function loadAlgoliaResults ({ version, language, query,
hitsPerPage: limit,
advancedSyntax: true,
highlightPreTag: '',
- highlightPostTag: ''
+ highlightPostTag: '',
+ filters
})
return hits.map(hit => ({
@@ -24,6 +25,7 @@ module.exports = async function loadAlgoliaResults ({ version, language, query,
breadcrumbs: get(hit, '_highlightResult.breadcrumbs.value'),
heading: get(hit, '_highlightResult.heading.value'),
title: get(hit, '_highlightResult.title.value'),
- content: get(hit, '_highlightResult.content.value')
+ content: get(hit, '_highlightResult.content.value'),
+ topics: hit.topics
}))
}
diff --git a/lib/search/lunr-search-index.js b/lib/search/lunr-search-index.js
index 05eb88ddc3..bde23b7f7e 100644
--- a/lib/search/lunr-search-index.js
+++ b/lib/search/lunr-search-index.js
@@ -46,6 +46,7 @@ module.exports = class LunrIndex {
this.field('heading')
this.field('title')
this.field('content')
+ this.field('topics')
this.field('customRanking')
this.metadataWhitelist = ['position']
diff --git a/lib/search/lunr-search.js b/lib/search/lunr-search.js
index 1a3e65f319..1a0d5db2b5 100644
--- a/lib/search/lunr-search.js
+++ b/lib/search/lunr-search.js
@@ -25,7 +25,9 @@ module.exports = async function loadLunrResults ({ version, language, query, lim
breadcrumbs: field(result, record, 'breadcrumbs'),
heading: field(result, record, 'heading'),
title: field(result, record, 'title'),
- content: field(result, record, 'content')
+ content: field(result, record, 'content'),
+ // don't highlight the topics array
+ topics: record.topics
}
})
return results
@@ -48,6 +50,7 @@ async function loadLunrRecords (indexName) {
.then(JSON.parse)
}
+// Highlight a match within an attribute field
function field (result, record, name) {
const text = record[name]
if (!text) return text
diff --git a/lib/search/parse-page-sections-into-records.js b/lib/search/parse-page-sections-into-records.js
index 79ac651f83..3c253ae617 100644
--- a/lib/search/parse-page-sections-into-records.js
+++ b/lib/search/parse-page-sections-into-records.js
@@ -12,7 +12,7 @@ const { maxContentLength } = require('./config')
module.exports = function parsePageSectionsIntoRecords (href, $) {
const title = $('h1').text().trim()
- const breadcrumbs = $('nav.breadcrumbs a')
+ const breadcrumbsArray = $('nav.breadcrumbs a')
.map((i, el) => {
return $(el)
.text()
@@ -21,7 +21,18 @@ module.exports = function parsePageSectionsIntoRecords (href, $) {
.replace(/\s+/g, ' ')
})
.get()
- .join(' / ')
+ .slice(0, -1)
+
+ const breadcrumbs = breadcrumbsArray.join(' / ') || ''
+ const metaKeywords = $('meta[name="keywords"]').attr('content')
+ const topics = metaKeywords ? metaKeywords.split(',') : []
+
+ const productName = breadcrumbsArray[0] || ''
+ topics.push(productName)
+ // Remove "github" to make filter queries shorter
+ if (productName.includes('GitHub ')) {
+ topics.push(productName.replace('GitHub ', ''))
+ }
let records
@@ -54,7 +65,8 @@ module.exports = function parsePageSectionsIntoRecords (href, $) {
breadcrumbs,
heading,
title,
- content
+ content,
+ topics
}
})
.get()
@@ -74,7 +86,8 @@ module.exports = function parsePageSectionsIntoRecords (href, $) {
url,
breadcrumbs,
title,
- content
+ content,
+ topics
}]
}
diff --git a/middleware/search.js b/middleware/search.js
index c430cc1b3a..149ad4285a 100644
--- a/middleware/search.js
+++ b/middleware/search.js
@@ -12,7 +12,7 @@ router.get('/', async function postSearch (req, res, next) {
'cache-control': 'private, no-store'
})
- const { query, version, language, limit: limit_ } = req.query
+ const { query, version, language, filters, limit: limit_ } = req.query
const limit = Math.min(parseInt(limit_, 10) || 10, 100)
if (!versions.has(version) || !languages.has(language)) {
return res.status(400).json([])
@@ -23,8 +23,8 @@ router.get('/', async function postSearch (req, res, next) {
try {
const results = process.env.AIRGAP
- ? await loadLunrResults({ version, language, query, limit })
- : await loadAlgoliaResults({ version, language, query, limit })
+ ? await loadLunrResults({ version, language, query: `${query} ${filters || ''}`, limit })
+ : await loadAlgoliaResults({ version, language, query, filters, limit })
return res.status(200).json(results)
} catch (err) {
console.error(err)
diff --git a/script/content-migrations/add-tags-to-articles.js b/script/content-migrations/add-tags-to-articles.js
index 9a6f43138c..e98e7fe172 100755
--- a/script/content-migrations/add-tags-to-articles.js
+++ b/script/content-migrations/add-tags-to-articles.js
@@ -48,6 +48,7 @@ function updateFrontmatter (filePath, newTopics) {
} else if (Array.isArray(data.topics)) {
topics = topics.concat(data.topics)
}
+
newTopics.forEach(topic => {
topics.push(topic)
})
diff --git a/script/rest/utils/create-code-samples.js b/script/rest/utils/create-code-samples.js
index ddb1d7bf6c..0bee5f1bf7 100644
--- a/script/rest/utils/create-code-samples.js
+++ b/script/rest/utils/create-code-samples.js
@@ -114,15 +114,18 @@ function getExampleBodyParams ({ operation }) {
return { [paramName]: getExampleParamValue(paramName, schema) }
}
- if (schema.oneOf) {
+ if (schema.oneOf && schema.oneOf[0].type) {
schema = schema.oneOf[0]
}
+
const props =
schema.required && schema.required.length > 0
? schema.required
: Object.keys(schema.properties).slice(0, 1)
+
return props.reduce((dict, propName) => {
const propSchema = schema.properties[propName]
+
if (!propSchema.deprecated) {
dict[propName] = getExampleParamValue(propName, propSchema)
}
@@ -137,8 +140,8 @@ function getExampleParamValue (name, schema) {
}
// TODO: figure out the right behavior here
- if (schema.oneOf) return getExampleParamValue(name, schema.oneOf[0])
- if (schema.anyOf) return getExampleParamValue(name, schema.anyOf[0])
+ if (schema.oneOf && schema.oneOf[0].type) return getExampleParamValue(name, schema.oneOf[0])
+ if (schema.anyOf && schema.anyOf[0].type) return getExampleParamValue(name, schema.anyOf[0])
switch (schema.type) {
case 'string':
diff --git a/tests/fixtures/page-versioned-for-ghae-next.md b/tests/fixtures/page-versioned-for-ghae-next.md
new file mode 100644
index 0000000000..7829f629ad
--- /dev/null
+++ b/tests/fixtures/page-versioned-for-ghae-next.md
@@ -0,0 +1,5 @@
+---
+title: Page versioned for next GitHub AE release
+versions:
+ github-ae: 'next'
+---
diff --git a/tests/fixtures/page-versioned-for-next-enterprise-release.md b/tests/fixtures/page-versioned-for-next-enterprise-release.md
new file mode 100644
index 0000000000..46a30ad849
--- /dev/null
+++ b/tests/fixtures/page-versioned-for-next-enterprise-release.md
@@ -0,0 +1,5 @@
+---
+title: Page versioned for next Enterprise release
+versions:
+ enterprise-server: '>=3.1'
+---
diff --git a/tests/unit/page.js b/tests/unit/page.js
index 3843e0abd7..988b278426 100644
--- a/tests/unit/page.js
+++ b/tests/unit/page.js
@@ -190,6 +190,36 @@ describe('Page class', () => {
expect($.text()).not.toBe('This text should render on any actively supported version of Enterprise Server')
expect($.text()).toBe('This text should only render on non-Enterprise')
})
+
+ test('support next to-be-released Enterprise Server version in frontmatter', async () => {
+ // This fixture has `enterprise-server: '>=3.1'` hardcoded in the frontmatter
+ const page = await Page.init({
+ relativePath: 'page-versioned-for-next-enterprise-release.md',
+ basePath: path.join(__dirname, '../fixtures'),
+ languageCode: 'en'
+ })
+ // set version to 3.0
+ const context = {
+ currentVersion: 'enterprise-server@3.0',
+ currentLanguage: 'en'
+ }
+ await expect(() => { return page.render(context) }).not.toThrow()
+ })
+
+ test('support next GitHub AE version in frontmatter', async () => {
+ // This fixture has `github-ae: 'next'` hardcoded in the frontmatter
+ const page = await Page.init({
+ relativePath: 'page-versioned-for-ghae-next.md',
+ basePath: path.join(__dirname, '../fixtures'),
+ languageCode: 'en'
+ })
+ // set version to @latest
+ const context = {
+ currentVersion: 'github-ae@latest',
+ currentLanguage: 'en'
+ }
+ await expect(() => { return page.render(context) }).not.toThrow()
+ })
})
test('preserves `languageCode`', async () => {
diff --git a/tests/unit/algolia/fixtures/page-with-sections.html b/tests/unit/search/fixtures/page-with-sections.html
similarity index 75%
rename from tests/unit/algolia/fixtures/page-with-sections.html
rename to tests/unit/search/fixtures/page-with-sections.html
index f61318d4c4..f6da35c328 100644
--- a/tests/unit/algolia/fixtures/page-with-sections.html
+++ b/tests/unit/search/fixtures/page-with-sections.html
@@ -1,8 +1,11 @@
+
+
+
I am the page title
diff --git a/tests/unit/algolia/fixtures/page-without-sections.html b/tests/unit/search/fixtures/page-without-sections.html
similarity index 56%
rename from tests/unit/algolia/fixtures/page-without-sections.html
rename to tests/unit/search/fixtures/page-without-sections.html
index 2c137527e6..4046e0a66c 100644
--- a/tests/unit/algolia/fixtures/page-without-sections.html
+++ b/tests/unit/search/fixtures/page-without-sections.html
@@ -1,10 +1,13 @@
+
+
+
I am outside the article and should not be included
A page without sections
diff --git a/tests/unit/algolia/parse-page-sections-into-records.js b/tests/unit/search/parse-page-sections-into-records.js
similarity index 79%
rename from tests/unit/algolia/parse-page-sections-into-records.js
rename to tests/unit/search/parse-page-sections-into-records.js
index e328f846f0..982a72a086 100644
--- a/tests/unit/algolia/parse-page-sections-into-records.js
+++ b/tests/unit/search/parse-page-sections-into-records.js
@@ -20,19 +20,21 @@ describe('search parsePageSectionsIntoRecords module', () => {
objectID: '/example/href#first',
url: 'https://docs.github.com/example/href#first',
slug: 'first',
- breadcrumbs: 'a / b / c',
+ breadcrumbs: 'GitHub Actions / actions learning path',
heading: 'First heading',
title: 'I am the page title',
- content: "Here's a paragraph. And another."
+ content: "Here's a paragraph. And another.",
+ topics: ['topic1', 'topic2', 'GitHub Actions', 'Actions']
},
{
objectID: '/example/href#second',
url: 'https://docs.github.com/example/href#second',
slug: 'second',
- breadcrumbs: 'a / b / c',
+ breadcrumbs: 'GitHub Actions / actions learning path',
heading: 'Second heading',
title: 'I am the page title',
- content: "Here's a paragraph in the second section. And another."
+ content: "Here's a paragraph in the second section. And another.",
+ topics: ['topic1', 'topic2', 'GitHub Actions', 'Actions']
}
]
@@ -50,9 +52,10 @@ describe('search parsePageSectionsIntoRecords module', () => {
{
objectID: '/example/href',
url: 'https://docs.github.com/example/href',
- breadcrumbs: 'x / y / z',
+ breadcrumbs: 'Education / map topic',
title: 'A page without sections',
- content: 'First paragraph. Second paragraph.'
+ content: 'First paragraph. Second paragraph.',
+ topics: ['key1', 'key2', 'key3', 'Education']
}
]
expect(records).toEqual(expected)
diff --git a/tests/unit/algolia/rank.js b/tests/unit/search/rank.js
similarity index 100%
rename from tests/unit/algolia/rank.js
rename to tests/unit/search/rank.js
diff --git a/tests/unit/search/topics.js b/tests/unit/search/topics.js
new file mode 100644
index 0000000000..67e31554bb
--- /dev/null
+++ b/tests/unit/search/topics.js
@@ -0,0 +1,32 @@
+const path = require('path')
+const fs = require('fs')
+const readFrontmatter = require('../../../lib/read-frontmatter')
+const walk = require('walk-sync')
+const { difference } = require('lodash')
+const allowedTopics = require('../../../data/allowed-topics')
+
+const contentDir = path.join(process.cwd(), 'content')
+const topics = walk(contentDir, { includeBasePath: true })
+ .filter(filename => filename.endsWith('.md') && !filename.includes('README'))
+ .map(filename => {
+ const fileContent = fs.readFileSync(filename, 'utf8')
+ const { data } = readFrontmatter(fileContent)
+ return data.topics || []
+ })
+ .flat()
+
+const allUsedTopics = [...new Set(topics)].sort()
+
+describe('Check for allowed frontmatter topics', () => {
+ test('all used topics are allowed in /data/allowed-topics.js', () => {
+ expect(allUsedTopics.length).toBeGreaterThan(0)
+ const unusedTopics = difference(allUsedTopics, allowedTopics)
+ expect(unusedTopics).toEqual([])
+ })
+
+ test('all allowed topics are used by at least one content file', () => {
+ expect(allowedTopics.length).toBeGreaterThan(0)
+ const disallowedTopics = difference(allowedTopics, allUsedTopics)
+ expect(disallowedTopics).toEqual([])
+ })
+})