diff --git a/.github/ISSUE_COMMENT_TEMPLATE/target-date.yml b/.github/ISSUE_COMMENT_TEMPLATE/target-date.yml
new file mode 100644
index 000000000000..1aaa0e3a0889
--- /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/.github/allowed-actions.js b/.github/allowed-actions.js
index 576ff559187d..2aaed21b79b0 100644
--- a/.github/allowed-actions.js
+++ b/.github/allowed-actions.js
@@ -39,6 +39,6 @@ module.exports = [
"repo-sync/pull-request@33777245b1aace1a58c87a29c90321aa7a74bd7d",
"someimportantcompany/github-actions-slack-message@0b470c14b39da4260ed9e3f9a4f1298a74ccdefd",
"tjenkinson/gh-action-auto-merge-dependency-updates@4d7756c04d9d999c5968697a621b81c47f533d61",
- "EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575",
+ "EndBug/add-and-commit@b3c7c1e078a023d75fb0bd326e02962575ce0519",
"dorny/paths-filter@eb75a1edc117d3756a18ef89958ee59f9500ba58",
];
diff --git a/.github/workflows/openapi-decorate.yml b/.github/workflows/openapi-decorate.yml
index 435bfac1d01b..d59b305a3df7 100644
--- a/.github/workflows/openapi-decorate.yml
+++ b/.github/workflows/openapi-decorate.yml
@@ -25,13 +25,10 @@ jobs:
run: script/rest/update-files.js --decorate-only
- name: Check in the decorated files
- uses: EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575
+ uses: EndBug/add-and-commit@b3c7c1e078a023d75fb0bd326e02962575ce0519
with:
# The arguments for the `git add` command
add: 'lib/rest/static/decorated'
# The message for the commit
message: 'Add decorated OpenAPI schema files'
-
- env:
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Leave this line unchanged
diff --git a/.github/workflows/ready-for-doc-review.yml b/.github/workflows/ready-for-doc-review.yml
new file mode 100644
index 000000000000..74243dac5507
--- /dev/null
+++ b/.github/workflows/ready-for-doc-review.yml
@@ -0,0 +1,22 @@
+name: Ready for docs-content review
+
+# **What it does**: Adds pull requests in the docs-internal repository to the docs-content first responder project board
+# **Why we have it**: So that other GitHub teams can easily request reviews from the docs-content team, and so that writers can see when a PR is ready for review
+# **Who does it impact**: Writers working in the docs-internal repository
+
+on:
+ pull_request:
+ types: [labeled]
+
+jobs:
+ request_doc_review:
+ name: Request a review from the docs-content team
+ if: github.event.label.name == 'ready-for-doc-review' && github.repository == 'github/docs-internal'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Add pull request to FR project board
+ uses: rachmari/actions-add-new-issue-to-column@1a459ef92308ba7c9c9dc2fcdd72f232495574a9
+ with:
+ action-token: ${{ secrets.DOCUBOT_FR_PROJECT_BOARD_WORKFLOWS_REPO_ORG_READ_SCOPES }}
+ project-url: 'https://github.com/orgs/github/projects/1367'
+ column-name: 'Docs-internal external contributor PRs'
diff --git a/.github/workflows/send-eng-issues-to-backlog.yml b/.github/workflows/send-eng-issues-to-backlog.yml
deleted file mode 100644
index 11ca0afd2f8d..000000000000
--- a/.github/workflows/send-eng-issues-to-backlog.yml
+++ /dev/null
@@ -1,30 +0,0 @@
-name: Send Issue to EPD backlog
-
-on:
- issues:
- types:
- - labeled
- - reopened
-
-jobs:
- triage:
- if: github.repository == 'github/docs-internal'
- runs-on: ubuntu-latest
- continue-on-error: true
- steps:
- - name: Add issues with engineering label to project board
- if: contains(github.event.issue.labels.*.name, 'engineering') || contains(github.event.issue.labels.*.name, 'design') || contains(github.event.issue.labels.*.name, 'Design')
- uses: actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9
- with:
- github-token: ${{ secrets.DOCUBOT_FR_PROJECT_BOARD_WORKFLOWS_REPO_ORG_READ_SCOPES }}
- script: |
- var column_id = 9659080;
- try {
- github.projects.createCard({
- column_id: column_id,
- content_id: context.payload.issue.id,
- content_type: "Issue"
- });
- } catch (error) {
- console.log(error);
- }
diff --git a/.github/workflows/send-issues-to-how-how-we-work-boards.yml b/.github/workflows/send-issues-to-how-how-we-work-boards.yml
new file mode 100644
index 000000000000..bf6e279ef5dd
--- /dev/null
+++ b/.github/workflows/send-issues-to-how-how-we-work-boards.yml
@@ -0,0 +1,58 @@
+name: Send Issue to How We Work Boards
+
+on:
+ issues:
+ types:
+ - labeled
+ - reopened
+
+jobs:
+ triage:
+ runs-on: ubuntu-latest
+ continue-on-error: true
+ steps:
+ - if: contains(github.event.issue.labels.*.name, 'engineering') && !contains(github.event.issue.labels.*.name, 'feature') && !contains(github.event.issue.labels.*.name, 'epic')
+ uses: actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9
+ with:
+ github-token: ${{ secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES }}
+ script: |
+ var column_id = 9659080;
+ try {
+ github.projects.createCard({
+ column_id: column_id,
+ content_id: context.payload.issue.id,
+ content_type: "Issue"
+ });
+ } catch (error) {
+ console.log(error);
+ }
+ - if: contains(github.event.issue.labels.*.name, 'engineering') && contains(github.event.issue.labels.*.name, 'feature')
+ uses: actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9
+ with:
+ github-token: ${{ secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES }}
+ script: |
+ var column_id = 13445681;
+ try {
+ github.projects.createCard({
+ column_id: column_id,
+ content_id: context.payload.issue.id,
+ content_type: "Issue"
+ });
+ } catch (error) {
+ console.log(error);
+ }
+ - if: contains(github.event.issue.labels.*.name, 'engineering') && contains(github.event.issue.labels.*.name, 'epic')
+ uses: actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9
+ with:
+ github-token: ${{ secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES }}
+ script: |
+ var column_id = 13445932;
+ try {
+ github.projects.createCard({
+ column_id: column_id,
+ content_id: context.payload.issue.id,
+ content_type: "Issue"
+ });
+ } catch (error) {
+ console.log(error);
+ }
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 14b78d9e4f9c..000000000000
Binary files a/assets/images/help/billing/ghas-seats-org.png and /dev/null differ
diff --git a/assets/images/help/dependabot/dependabot-secrets.png b/assets/images/help/dependabot/dependabot-secrets.png
new file mode 100644
index 000000000000..74aba9a0bbc0
Binary files /dev/null and b/assets/images/help/dependabot/dependabot-secrets.png differ
diff --git a/assets/images/help/dependabot/secret-repository-access.png b/assets/images/help/dependabot/secret-repository-access.png
new file mode 100644
index 000000000000..a4bd31286156
Binary files /dev/null and b/assets/images/help/dependabot/secret-repository-access.png differ
diff --git a/assets/images/help/dependabot/update-remove-org-secret.png b/assets/images/help/dependabot/update-remove-org-secret.png
new file mode 100644
index 000000000000..94b7a0b8045c
Binary files /dev/null and b/assets/images/help/dependabot/update-remove-org-secret.png differ
diff --git a/assets/images/help/dependabot/update-remove-repo-secret.png b/assets/images/help/dependabot/update-remove-repo-secret.png
new file mode 100644
index 000000000000..dcbc3a0df463
Binary files /dev/null and b/assets/images/help/dependabot/update-remove-repo-secret.png 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 000000000000..b5a3fa3af074
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 000000000000..9b6a485bfaca
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 7006ce5c96d7..000000000000
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 adf499d586cc..50f07869cc6f 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 79aa0fca8b3f..45b571c32317 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 000000000000..618af66b80e5
--- /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 000000000000..461ef0aca2ff
--- /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 000000000000..50f5ad45a416
--- /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 38acc216796f..85043ac3f701 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 000000000000..650cbea90d1d
--- /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 000000000000..7ab58f630856
--- /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 000000000000..d61c7f7ea639
--- /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 000000000000..d023cb4e2c0f
--- /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 5880ba20fd5e..d5b53f25cfeb 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/events-that-trigger-workflows.md b/content/actions/reference/events-that-trigger-workflows.md
index 9f3e2327e2ec..d1e9e8de83ed 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 c59edbf1010c..2ab089a0ed64 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 9883e1bca38e..c5431f7372f2 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 bbcebb10c5a3..8a6228e0bb80 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 c1ccb9a41745..097850a1339d 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 e21b5d8ae4f2..cc0d48b47cd1 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 b3f8f58c0532..b9a864ebe2a6 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 5987411ce0d9..cd9861decca8 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 deacdaf76f0d..b55ee5094f13 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 4df510e488bc..0e05f30cd0dd 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 fa765d66b83b..d5c29850907b 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 959c6df2fba4..53858a708b76 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 e4cdd3808ee9..2da3fd18ccfa 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 8f90db06228d..1436036526e0 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 73cf3530c7eb..939c25bd3797 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 94a312d87735..62921a128c10 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 d10388e2f96f..6abacadb3cf2 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 3e7bd4b662ab..981e4abd9f6c 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 e9a8a1113feb..353c1e424618 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 8a398553fa42..b58ca8f40074 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 534c4c76d9af..da0908fc888f 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 dbea15fc2644..62754fac2419 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 1ee5bcda80c2..73415a9df1f4 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 7b579bfe1dd9..152e36452ec1 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 5e3dd8edbf83..89d69a723c34 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 665d0177ca72..25ae0e9c526d 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 29a92ff609f6..3a27d659cc6b 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 b5d7abf7e09d..fe94a7b2b0c1 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 5cffccdf1693..46f56ef79e54 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 b806b45f2995..361702b4b3bb 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 c8b25b42dcc7..f814b48cf9c9 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 d9042f873dcf..a71272ab860a 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 fd106938d1f5..4b9d1bb375d5 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 5afbbe175155..641f5e61093a 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 f3e412341cfb..30be76ad5171 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 8d25c497ef94..3311ca660537 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 832241da5f92..52dfaa160ba6 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 a320a62917a3..3c161a317111 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 831e440b7ff8..1e32ab673fbc 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 76012af69f84..782d4033e734 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 7c85654bea55..2d609c74fbc5 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 33130ca6fe11..d34e2ebdba38 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 ee042551f25e..1cfa0079a803 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 63e4e25bee0e..1fd17e838ec0 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 66de92b8f4d4..fb7b3fe2dc6b 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 9a4688b5f2db..22f578d8d347 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 da953a8cd384..df0c32529228 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 61c4bb3ce97a..8271cc47b2ce 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 539b679d7354..869cc35ff04c 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 1c731a310c8a..581679b205db 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 74a1a75fe313..463b8781a0c5 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 8b3345da8547..1a1157bb0d43 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 dfa868e556a8..b72945375ba8 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 724be83b78a7..19b544937193 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 a83ec1d35979..b7182b0edf1d 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 b11cc7bb1fd5..80f91507d721 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 6fc9f34af1ac..6752ddf050c8 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 4196beb841db..7ce2e846c811 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 9cf229f15455..deb7ebbf601b 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 84b7b0ae9f98..bd994c784885 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 9c124a1eb876..8a032953fbdf 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 9ac3ba2f73fb..59d4847dd947 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 07f741e1bc61..3c53bfa0a555 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 c429e9270723..a93e152668b8 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 70ad38778a38..ce3e4a1acd48 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 2c893b226eb9..1db820873166 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 faaf069973dc..cc6f503d0af2 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 1fc88c484a53..4ada1342843e 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 208fe0e10db3..7a9d0c47f595 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 2b0406038c92..baa4b482d36d 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 536933512434..f28668eb3a9d 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 da5fcdd1c91b..4916df38ad20 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 2ef67fbbef09..bcc5821b39f8 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 e8adac6a1100..a73f9c02e380 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 ceae6ab760aa..3898e09a0b7d 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 879390f39009..cc9cd0027eb8 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 6002b89d1bb4..7f3ab841b7aa 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 4dde19d03866..2f96afbd7d58 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 f0163ff946e8..21031f8d8f89 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 3c590160d033..b40afca279f0 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 60da0b3d304e..c06792a75158 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 1be8e7d8b5cc..19fd10ebcd78 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 daefc6db50fb..a839c0341094 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 696ce3441c65..f731cfec522d 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 ecdcf023223f..de2131bec7ae 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 b55487a008e0..8553ddf3dac4 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 f1eadede3a1e..d9f8d78ef9d1 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 d6f1ed919145..1393d3bc8194 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 67f3ad9d93fd..ce8e4498c5e8 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 9c70a25abf5e..4f0ebdb6d5f4 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 2bb07afaab08..3ea698137236 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 7cf256ce5605..51d55999d7dd 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 98b3cd0eeaf2..c700ae6897bb 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 5f396e34caac..cb1682372894 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 3b3b6da7eb2e..e87d29f61ffe 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 fa3f0a4aa74d..609640ef9957 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 a2556020e8d7..1a687f2e87bf 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 5be939738461..8235057e0215 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 886b40a7865d..1ab36ce2a1e5 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 1e94369d9869..f545d4949420 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 a9b21f3001d6..12451374388b 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 d86f1a64b58b..ba2c6c47ab3d 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 82df246b4335..b9f5e4fcf280 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 534f37520e13..4cba468196c4 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 26ccc90fba59..c893e6c059ac 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 e95b18f98a29..6caf9cf8e216 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 51d601c89f2e..78e01a4ca39d 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 f36947c4bc9c..3f8f07e6ba8a 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 dfc57ac64bc3..a380a9961e6c 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 df08b0d047c9..5ef91e72d9ed 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 f2d387de55b0..d463c8a01cd8 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 ca489927cc7f..582246e33e86 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 50d3baa627cf..f6de6fe0ee42 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 be1006b3f79a..008413e67ecc 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 e21838d06a78..6f8015897179 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 42a146e2f9e0..eded2b581a73 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 2695c4d61259..79453ba7f6f9 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 ce4f58e9bb3c..0646a0cdeafe 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 fb0341074dbd..7b871086612d 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 92a5f510c953..865536adbe56 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 972f5439d395..082e71f7fe55 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 4c37b9eed58f..42352b9ac151 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 8f75a39a0715..d79b6c703a25 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 f25eeb31ca24..475fea0e5fd0 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 97c0ba8c0346..8b8000cdc4d2 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 b5c69a8999af..5318d5ca0820 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 c86afe795a13..a84cc7b275c4 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 1f15dc49c27f..b544920183a0 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 4cfb1b01231b..d1ac35a26000 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 65fd3656219c..913cfba14ce8 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 b0cec33688e6..9123b05147ad 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 9f92df1f8777..16aae55c86ce 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 9808ef3fde91..b4f90820e7a9 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 646d1454a26c..fc418b26e2f5 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 ec699e2ccff9..effb31b1b4fc 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 64ab4099fcfb..f79812973383 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 c501d76e583f..71f3a8e9716f 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 b3673275fc59..c5583b723d56 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 49c8daec918b..62f4721a650e 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 de657754d33a..adb7c0bf5099 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 9c665ea89426..2588b9ba09aa 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 806dd27df9c5..78a8dbb31f01 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 4010feb87963..3608580c91c5 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 e04bdf4f4a50..4761a7756131 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 5fb4fce0d924..36572f7c9092 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 0a94dea0aa6e..cae2ec54c94a 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 8a8da98e14bd..d4eb94ca047d 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 57ed82a23046..eaf820e04b87 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 fca0dbe5be6b..fa8aee9730d2 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 015fe8c7a20d..d644c7cbeb89 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 beae6174be88..a0de18848f31 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 e51686cb1fbb..bd222612722f 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 6551ad31f8f0..4b051cbd69d7 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 8f1ebe6bdabd..74cc0fc96400 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 96c25bbb5a35..73de8300827b 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 8d20c8a7ad12..fb040c543b88 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 1578faba94f5..ed0284421ee8 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 7856792cb08b..6112f4c241b8 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 da606dbe919c..a777e740e35e 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 8a81872d82e7..4fce02539d21 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 73f06725687e..6bbed26d46a8 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 00ad4741f35e..c30299376ffa 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 9aaaccfb90aa..99c8980a2c84 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 e34217f4ca5e..8dfcaa45e9da 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 08415450a9a5..0fddb06a87c6 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 fb919a17696a..c6ea376e2257 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 4da07ed3b7a1..bf4eb99cac54 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 63a373005fbd..f5ee73f94a4c 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 a3df463ac39c..216d8e3aa4b6 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 e1a120ba63e2..47abddf047f4 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 509a9e1a1197..c3abc3d40b72 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 a72fde4deb4f..4c8ae9bd38c2 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 20a81d080e50..881f91d4b996 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 c6e85b46cc27..b0b294e4cecd 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 1a1f09c7768e..41355830c4cd 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 8370cad87091..225c8efd4b36 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 12b6e32f2895..8ad18007f07f 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 3887587f9060..2d4d6eace68d 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 32cff3f262c0..a60123ce08d8 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 9495d0dc5c9c..aa9caf2db5fd 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 ce82b3bb93fe..ba313b6765be 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 3ae71bf8105e..f7e8ea77c0c5 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 19fb57249315..3481540a90ac 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 fff85efbab0d..e1c19c1da530 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 ef5f534d5b0f..79ef3adf879b 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 c4d09073ff59..46ab929b327b 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" %}
diff --git a/content/developers/apps/authorizing-oauth-apps.md b/content/developers/apps/authorizing-oauth-apps.md
index 4a9ab098cc4a..cbf94e9baeba 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 91bb4479af95..8c79f0099541 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 ccedbd626704..16fbbbf52332 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 c39b720c268f..2f26017f1c6e 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 9945833d00fc..f39207563edb 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 7c18a8b460cc..22c65eacfa26 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 99d0f03a93da..a4794039eab7 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 cae49a410a84..63b95c7eaeee 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 c885dc21341f..0340b236ef86 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 e964e7b0550e..8d8bd1e520ff 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 6c32b8f7f9fd..7c40c0b61d69 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 cdf87e56e0f1..75eb74ad1a97 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 091642a8f791..c1c8b1c125a2 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 d57db219a1e6..62ec4ae5c0c5 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 d6bc3d7a0f13..46aa599b97b7 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 1e90f02406a7..125c0f5c42ca 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 0c27bda88388..6f235d3ca06e 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 e384433f901b..5dab758c53fb 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 c997ded78ac8..59215beea0a4 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 036d3d589dfa..37f0bee15c58 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 fb3b9c3934b7..0bab3a14a562 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 e1bf769dedc6..18cb006f9119 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 21fbe532f286..eedbac7a4c33 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 47392e13f0d8..39278961f90d 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 73beec333732..7b15a86e19f9 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 31607e2e14bb..2451916675d5 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 3a21601f34cd..ca66b82b31bd 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 366efeb18ba2..db6e24564976 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 547f4457581c..4d9c1fb5572d 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 3a35ecc6da70..6e4d57a59744 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 8ec4ca2e0635..a619a278102b 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 118908599d38..0d9f093edf21 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 59d1b1adc382..023d8477dd5e 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 4620a4aa352b..aed485cc2bed 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 c6b54ed2b21b..af14d423072a 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 ed9e9fde07dc..8fc92254359a 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 ebd8e6ed7151..d12842949950 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 a5566fb0121e..cc3ca5561e2b 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 8919eee16ef6..f6c6257f9d79 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 ed6701d67117..2e578e145869 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 6ed97feecdb9..00e34854f16b 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 342754e94dfb..1db26ad8f208 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 4107fa4427f4..b739663a7dad 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 c495928b43cf..85fcb55cc2fa 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 94b29c63ff7a..0809b8196c49 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 ed287efb5efd..2334e0fe9a57 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 7fb64dd96c03..a567ed24d957 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 9d018cfe810f..96571894ae00 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 58924a15d0ef..cfe604c53ed6 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 8e765778101b..33e7aeecccc0 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 0264e77e2ec2..85bb10404272 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 3a2a3d1be37b..05213fa2b8f7 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 db3482b99240..09ae762f8873 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 fac3d2fcf682..b8be78bbfa6f 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 e468593f58f7..5b643723ff3d 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 14fb5e0e67ce..7b7f3014d482 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 f56182b6ba7f..eba474e22eb6 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 577b6d624a35..e587a94908e4 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 79b8ccfe4321..684636305145 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 de4918046671..3621b2e7b8aa 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 b0c801eaa06a..60f69eafb425 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 96594bbc6146..71772c127c22 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 7dabc220bbe3..50544a871f99 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 e60baa72e325..7141a1ac7455 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 343241fd6fcc..947b290ce3e4 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 d97cec639142..ad419e871707 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 878a316bd5b2..05f75c507968 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 278f89e67288..9c2d39bf94f0 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 81b5ffbd5f04..dfa6e0efc483 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 05d8099b7812..5d9f72158188 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 3123eb318316..1c4708f577e0 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 c4787dcc97ce..42464d48efa3 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 17d3ac7a2450..ab6e95e7bb98 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 6fead511c2a3..761e6b24722d 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 72098b42fa5d..74579398db1a 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 8fe5ba3cd8d9..e433da040333 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 9da44234bd73..41380543d17d 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 c32343b777a2..cfdf4c9a1ed1 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 37357733633b..ba40fe2cb43b 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 2336205b8530..1ceeba193987 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
---
diff --git a/content/developers/webhooks-and-events/webhooks.md b/content/developers/webhooks-and-events/webhooks.md
index ce6641349041..9a1347c894be 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 e4cc2321b6c6..6631fd4d3ccc 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 11f5a21c948e..d96a8719f3eb 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 %}
@@ -40,7 +41,9 @@ You can configure version updates for repositories that contain a dependency man
{% note %}
-{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. See the details in the table below.
+{% data reusables.dependabot.private-dependencies-note %}
+
+{% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. See the details in the table below.
{% endnote %}
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 792bfec4bcf3..88b8fbb6d77e 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 d8928317a6d9..6533a3ec45c7 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 c842929a11b3..1dc9ce75c336 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 81ade4c4b07f..fc0699c303e2 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 8835b2c460b4..38696dfe50df 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 e383cbb71e69..a98f29f30471 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 a24e1145b917..10e4011e888f 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 cefd27c27174..f1f0f892bd79 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 a187c9313d94..8918184c6ba3 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 7e57598c486d..ae83a329db25 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 efb5609671d9..bae978220c04 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
@@ -2,8 +2,11 @@
title: Configuration options for dependency updates
intro: 'Detailed information for all the options you can use to customize how {% data variables.product.prodname_dependabot %} maintains your repositories.'
permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_dependabot %} for the repository.'
+miniTocMaxHeadingLevel: 4
versions:
free-pro-team: '*'
+topics:
+ - repositories
---
{% data reusables.dependabot.beta-note %}
@@ -14,9 +17,11 @@ The {% data variables.product.prodname_dependabot %} configuration file, *depend
You must store this file in the `.github` directory of your repository. When you add or update the *dependabot.yml* file, this triggers an immediate check for version updates. Any options that also affect security updates are used the next time a security alert triggers a pull request for a security update. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)" and "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)."
-### Configuration options for *dependabot.yml*
+The *dependabot.yml* file has two mandatory top-level keys: `version`, and `updates`. You can, optionally, include a top-level `registries` key. The file must start with `version: 2`.
-The *dependabot.yml* file must start with `version: 2` followed by an array of `updates`.
+### Configuration options for updates
+
+The top-level `updates` key is mandatory. You use it to configure how {% data variables.product.prodname_dependabot %} updates the versions or your project's dependencies. Each entry configures the update settings for a particular package manager. You can use the following options.
| Option | Required | Description |
|:---|:---:|:---|
@@ -27,11 +32,13 @@ The *dependabot.yml* file must start with `version: 2` followed by an array of `
| [`assignees`](#assignees) | | Assignees to set on pull requests |
| [`commit-message`](#commit-message) | | Commit message preferences |
| [`ignore`](#ignore) | | Ignore certain dependencies or versions |
+| [`insecure-external-code-execution`](#insecure-external-code-execution) | | Allow or deny code execution in manifest files |
| [`labels`](#labels) | | Labels to set on pull requests |
| [`milestone`](#milestone) | | Milestone to set on pull requests |
| [`open-pull-requests-limit`](#open-pull-requests-limit) | | Limit number of open pull requests for version updates|
| [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) | | Change separator for pull request branch names |
| [`rebase-strategy`](#rebase-strategy) | | Disable automatic rebasing |
+| [`registries`](#registries) | | Private registries that {% data variables.product.prodname_dependabot %} can access|
| [`reviewers`](#reviewers) | | Reviewers to set on pull requests |
| [`schedule.day`](#scheduleday) | | Day of week to check for updates |
| [`schedule.time`](#scheduletime) | | Time of day to check for updates (hh:mm) |
@@ -60,9 +67,9 @@ In general, security updates use any configuration options that affect pull requ
{% endnote %}
-### `package-ecosystem`
+#### `package-ecosystem`
-**Required** You add one `package-ecosystem` element for each package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file for each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below.
+**Required**. You add one `package-ecosystem` element for each package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file for each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below.
{% data reusables.dependabot.supported-package-managers %}
@@ -91,9 +98,9 @@ updates:
interval: "daily"
```
-### `directory`
+#### `directory`
-**Required** You must define the location of the package manifests for each package manager (for example, the *package.json* or *Gemfile*). You define the directory relative to the root of the repository for all ecosystems except GitHub Actions. For GitHub Actions, set the directory to `/` to check for workflow files in `.github/workflows`.
+**Required**. You must define the location of the package manifests for each package manager (for example, the *package.json* or *Gemfile*). You define the directory relative to the root of the repository for all ecosystems except GitHub Actions. For GitHub Actions, set the directory to `/` to check for workflow files in `.github/workflows`.
```yaml
# Specify location of manifest files for each package manager
@@ -120,9 +127,9 @@ updates:
interval: "daily"
```
-### `schedule.interval`
+#### `schedule.interval`
-**Required** You must define how often to check for new versions for each package manager. By default, this is at 5am UTC. To modify this, use [`schedule.time`](#scheduletime) and [`schedule.timezone`](#scheduletimezone).
+**Required**. You must define how often to check for new versions for each package manager. By default, this is at 5am UTC. To modify this, use [`schedule.time`](#scheduletime) and [`schedule.timezone`](#scheduletimezone).
- `daily`—runs on every weekday, Monday to Friday.
- `weekly`—runs once each week. By default, this is on Monday. To modify this, use [`schedule.day`](#scheduleday).
@@ -153,7 +160,7 @@ updates:
{% endnote %}
-### `allow`
+#### `allow`
{% data reusables.dependabot.default-dependencies-allow-ignore %}
@@ -171,7 +178,7 @@ Use the `allow` option to customize which dependencies are updated. This has no
| `development`| `bundler`, `composer`, `mix`, `maven`, `npm`, `pip` | Only dependencies in the "Development dependency group". |
```yaml
-# Customizing the dependencies to maintain with `allow`
+# Use `allow` to specify which dependencies to maintain
version: 2
updates:
@@ -207,7 +214,7 @@ updates:
dependency-type: "production"
```
-### `assignees`
+#### `assignees`
Use `assignees` to specify individual assignees for all pull requests raised for a package manager.
@@ -227,7 +234,7 @@ updates:
- "octocat"
```
-### `commit-message`
+#### `commit-message`
By default, {% data variables.product.prodname_dependabot %} attempts to detect your commit message preferences and use similar patterns. Use the `commit-message` option to specify your preferences explicitly.
@@ -240,7 +247,7 @@ Supported options
{% data reusables.dependabot.option-affects-security-updates %}
```yaml
-# Customizing commit messages
+# Customize commit messages
version: 2
updates:
@@ -274,17 +281,17 @@ updates:
include: "scope"
```
-### `ignore`
+#### `ignore`
{% data reusables.dependabot.warning-ignore-option %}
-#### Checking for existing ignore preferences
+##### Checking for existing ignore preferences
Before you add an `ignore` option to the configuration file, check whether you've previously used any of the `@dependabot ignore` commands on a security update or version update pull request. {% data variables.product.prodname_dependabot %} stores these preferences for each package manager centrally and this information is overwritten by the `ignore` option. For more information about the `@dependabot ignore` commands, see "[Managing pull requests for dependency updates](/github/administering-a-repository/managing-pull-requests-for-dependency-updates)."
You can check whether a repository has stored preferences by searching the repository for `"@dependabot ignore" in:comments`. If you review any pull requests in the results, you can decide whether or not to specify those ignored dependencies or versions in the configuration file.
-#### Specifying dependencies and versions to ignore
+##### Specifying dependencies and versions to ignore
{% data reusables.dependabot.default-dependencies-allow-ignore %}
@@ -296,7 +303,7 @@ You can use the `ignore` option to customize which dependencies are updated. The
{% data reusables.dependabot.option-affects-security-updates %}
```yaml
-# Customizing the dependencies to maintain with `ignore`
+# Use `ignore` to specify dependencies that should not be updated
version: 2
updates:
@@ -314,12 +321,38 @@ updates:
{% note %}
-**Note**: {% data variables.product.prodname_dependabot %} can only run version updates on manifest or lock files if it can access all of the dependencies in the file, even if you add inaccessible dependencies to the `ignore` option of your configuration file. 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#allowing-dependabot-to-access-private-repositories)" and "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors#dependabot-cant-resolve-your-dependency-files)."
+**Note**: {% data variables.product.prodname_dependabot %} can only run version updates on manifest or lock files if it can access all of the dependencies in the file, even if you add inaccessible dependencies to the `ignore` option of your configuration file. 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#allowing-dependabot-to-access-private-dependencies)" and "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors#dependabot-cant-resolve-your-dependency-files)."
{% endnote %}
-### `labels`
+#### `insecure-external-code-execution`
+
+Package managers with the `package-ecosystem` values `bundler`, `mix`, and `pip` may execute external code in the manifest as part of the version update process. This might allow a compromised package to steal credentials or gain access to configured registries. When you add a [`registries`](#registries) setting within an `updates` configuration, {% data variables.product.prodname_dependabot %} automatically prevents external code execution, in which case the version update may fail. You can choose to override this behavior and allow external code execution for `bundler`, `mix`, and `pip` package managers by setting `insecure-external-code-execution` to `allow`.
+
+You can explicitly deny external code execution, irrespective of whether there is a `registries` setting for this update configuration, by setting `insecure-external-code-execution` to `deny`.
+
+{% raw %}
+```yaml
+# Allow external code execution when updating dependencies from private registries
+
+version: 2
+registries:
+ ruby-github:
+ type: rubygems-server
+ url: https://rubygems.pkg.github.com/octocat/github_api
+ token: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+updates:
+ - package-ecosystem: "bundler"
+ directory: "/rubygems-server"
+ insecure-external-code-execution: allow
+ registries: "*"
+ schedule:
+ interval: "monthly"
+```
+{% endraw %}
+
+#### `labels`
{% data reusables.dependabot.default-labels %}
@@ -343,7 +376,7 @@ updates:
- "dependencies"
```
-### `milestone`
+#### `milestone`
Use `milestone` to associate all pull requests raised for a package manager with a milestone. You need to specify the numeric identifier of the milestone and not its label. If you view a milestone, the final part of the page URL, after `milestone`, is the identifier. For example: `https://github.com///milestone/3`.
@@ -362,14 +395,14 @@ updates:
milestone: 4
```
-### `open-pull-requests-limit`
+#### `open-pull-requests-limit`
By default, {% data variables.product.prodname_dependabot %} opens a maximum of five pull requests for version updates. Once there are five open pull requests, new requests are blocked until you merge or close some of the open requests, after which new pull requests can be opened on subsequent updates. Use `open-pull-requests-limit` to change this limit. This also provides a simple way to temporarily disable version updates for a package manager.
This option has no impact on security updates, which have a separate, internal limit of ten open pull requests.
```yaml
-# Changing the number of open pull requests allowed
+# Specify the number of open pull requests allowed
version: 2
updates:
@@ -388,7 +421,7 @@ updates:
open-pull-requests-limit: 10
```
-### `pull-request-branch-name.separator`
+#### `pull-request-branch-name.separator`
{% data variables.product.prodname_dependabot %} generates a branch for each pull request. Each branch name includes `dependabot`, and the package manager and dependency that are updated. By default, these parts are separated by a `/` symbol, for example: `dependabot/npm_and_yarn/next_js/acorn-6.4.1`.
@@ -397,7 +430,7 @@ Use `pull-request-branch-name.separator` to specify a different separator. This
{% data reusables.dependabot.option-affects-security-updates %}
```yaml
-# Specifying a different separator for branch names
+# Specify a different separator for branch names
version: 2
updates:
@@ -411,7 +444,7 @@ updates:
separator: "-"
```
-### `rebase-strategy`
+#### `rebase-strategy`
By default, {% data variables.product.prodname_dependabot %} automatically rebases open pull requests when it detects conflicts. Use `rebase-strategy` to disable this behavior.
@@ -423,7 +456,7 @@ Available rebase strategies
{% data reusables.dependabot.option-affects-security-updates %}
```yaml
-# Disabling automatic rebasing
+# Disable automatic rebasing
version: 2
updates:
@@ -435,7 +468,39 @@ updates:
rebase-strategy: "disabled"
```
-### `reviewers`
+#### `registries`
+
+To allow {% data variables.product.prodname_dependabot %} to access a private package registry when performing a version update, you must include a `registries` setting within the relevant `updates` configuration. You can allow all of the defined registries to be used by setting `registries` to `"*"`. Alternatively, you can list the registries that the update can use. To do this, use the name of the registry as defined in the top-level `registries` section of the _dependabot.yml_ file.
+
+To allow {% data variables.product.prodname_dependabot %} to use `bundler`, `mix`, and `pip` package managers to update dependencies in private registries, you can choose to allow external code execution. For more information, see [`insecure-external-code-execution`](#insecure-external-code-execution).
+
+{% raw %}
+```yaml
+# Allow {% data variables.product.prodname_dependabot %} to use one of the two defined private registries
+# when updating dependency versions for this ecosystem
+
+version: 2
+registries:
+ maven-github:
+ type: maven-repository
+ url: https://maven.pkg.github.com/octocat
+ token: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+ npm-npmjs:
+ type: npm-registry
+ url: https://registry.npmjs.org
+ username: octocat
+ password: ${{secrets.MY_NPM_PASSWORD}}
+updates:
+ - package-ecosystem: "gitsubmodule"
+ directory: "/"
+ registries:
+ - maven-github
+ schedule:
+ interval: "monthly"
+```
+{% endraw %}
+
+#### `reviewers`
Use `reviewers` to specify individual reviewers or teams of reviewers for all pull requests raised for a package manager. You must use the full team name, including the organization, as if you were @mentioning the team.
@@ -457,7 +522,7 @@ updates:
- "my-org/python-team"
```
-### `schedule.day`
+#### `schedule.day`
When you set a `weekly` update schedule, by default, {% data variables.product.prodname_dependabot %} checks for new versions on Monday at 05:00 UTC. Use `schedule.day` to specify an alternative day to check for updates.
@@ -484,7 +549,7 @@ updates:
day: "sunday"
```
-### `schedule.time`
+#### `schedule.time`
By default, {% data variables.product.prodname_dependabot %} checks for new versions at 05:00 UTC. Use `schedule.time` to specify an alternative time of day to check for updates (format: `hh:mm`).
@@ -500,7 +565,7 @@ updates:
time: "09:00"
```
-### `schedule.timezone`
+#### `schedule.timezone`
By default, {% data variables.product.prodname_dependabot %} checks for new versions at 05:00 UTC. Use `schedule.timezone` to specify an alternative time zone. The time zone identifier must be from the Time Zone database maintained by [iana](https://www.iana.org/time-zones). For more information, see [List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
@@ -518,7 +583,7 @@ updates:
timezone: "Asia/Tokyo"
```
-### `target-branch`
+#### `target-branch`
By default, {% data variables.product.prodname_dependabot %} checks for manifest files on the default branch and raises pull requests for version updates against this branch. Use `target-branch` to specify a different branch for manifest files and for pull requests. When you use this option, the settings for this package manager will no longer affect any pull requests raised for security updates.
@@ -549,7 +614,7 @@ updates:
- "npm dependencies"
```
-### `vendor`
+#### `vendor`
Use the `vendor` option to tell {% data variables.product.prodname_dependabot %} to vendor dependencies when updating them. Don't use this option if you're using `gomod` as {% data variables.product.prodname_dependabot %} automatically detects vendoring for this tool.
@@ -574,7 +639,7 @@ updates:
| `gomod` | No path requirement (dependencies are usually located in the _vendor_ directory) | [`go mod vendor` documentation](https://golang.org/ref/mod#go-mod-vendor) |
-### `versioning-strategy`
+#### `versioning-strategy`
When {% data variables.product.prodname_dependabot %} edits a manifest file to update a version, it uses the following overall strategies:
@@ -596,7 +661,7 @@ Available update strategies
| `increase-if-necessary` | `bundler`, `composer`, `npm` | Increase the version requirement only when required by the new version. |
```yaml
-# Customizing the manifest version strategy
+# Customize the manifest version strategy
version: 2
updates:
@@ -624,3 +689,222 @@ updates:
# ignore any version updates that affect the manifest
versioning-strategy: lockfile-only
```
+
+### Configuration options for private registries
+
+The top-level `registries` key is optional. It allows you to specify authentication details that {% data variables.product.prodname_dependabot %} can use to access private package registries.
+
+{% note %}
+
+**Note:** Private registries behind firewalls on private networks are not supported.
+
+{% endnote %}
+
+The value of the `registries` key is an associative array, each element of which consists of a key that identifies a particular registry and a value which is an associative array that specifies the settings required to access that registry. The following *dependabot.yml* file, configures a registry identified as `dockerhub` in the `registries` section of the file and then references this in the `updates` section of the file.
+
+{% raw %}
+```yaml
+# Minimal settings to update dependencies in one private registry
+
+version: 2
+registries:
+ dockerhub: # Define access for a private registry
+ type: docker-registry
+ url: registry.hub.docker.com
+ username: octocat
+ password: ${{secrets.DOCKERHUB_PASSWORD}}
+updates:
+ - package-ecosystem: "docker"
+ directory: "/docker-registry/dockerhub"
+ registries:
+ - dockerhub # Allow version updates for dependencies in this registry
+ schedule:
+ interval: "monthly"
+```
+{% endraw %}
+
+You use the following options to specify access settings. Registry settings must contain a `type` and a `url`, and typically either a `username` and `password` combination or a `token`.
+
+| Option | Description |
+|:---|:---|
+| `type` | Identifies the type of registry. See the full list of types below. |
+| `url` | The URL to use to access the dependencies in this registry. The protocol is optional. If not specified, `https://` is assumed. {% data variables.product.prodname_dependabot %} adds or ignores trailing slashes as required. |
+| `username` | The username that {% data variables.product.prodname_dependabot %} uses to access the registry. |
+| `password` | A reference to a {% data variables.product.prodname_dependabot %} secret containing the password for the specified user. For more information, see "[Managing encrypted secrets for Dependabot](/github/administering-a-repository/managing-encrypted-secrets-for-dependabot)." |
+| `token` | A reference to a {% data variables.product.prodname_dependabot %} secret containing an access token for this registry. For more information, see "[Managing encrypted secrets for Dependabot](/github/administering-a-repository/managing-encrypted-secrets-for-dependabot)." |
+| `replaces-base` | For registries with `type: python-index`, if the boolean value is `true`, pip resolves dependencies by using the specified URL rather than the base URL of the Python Package Index (by default `https://pypi.org/simple`). |
+
+
+Each configuration `type` requires you to provide particular settings. Some types allow more than one way to connect. The following sections provide details of the settings you should use for each `type`.
+
+#### `composer-repository`
+
+The `composer-repository` type supports username and password.
+
+{% raw %}
+```yaml
+registries:
+ composer:
+ type: composer-repository
+ url: https://repo.packagist.com/example-company/
+ username: octocat
+ password: ${{secrets.MY_PACKAGIST_PASSWORD}}
+```
+{% endraw %}
+
+#### `docker-registry`
+
+The `docker-registry` type supports username and password.
+
+{% raw %}
+```yaml
+registries:
+ dockerhub:
+ type: docker-registry
+ url: https://registry.hub.docker.com
+ username: octocat
+ password: ${{secrets.MY_DOCKERHUB_PASSWORD}}
+```
+{% endraw %}
+
+#### `git`
+
+The `git` type supports username and password.
+
+{% raw %}
+```yaml
+registries:
+ github-octocat:
+ type: git
+ url: https://github.com
+ username: x-access-token
+ password: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+```
+{% endraw %}
+
+#### `maven-repository`
+
+The `maven-repository` type supports username and password, or token.
+
+{% raw %}
+```yaml
+registries:
+ maven-artifactory:
+ type: maven-repository
+ url: https://artifactory.example.com
+ username: octocat
+ password: ${{secrets.MY_ARTIFACTORY_PASSWORD}}
+```
+{% endraw %}
+
+{% raw %}
+```yaml
+registries:
+ maven-github:
+ type: maven-repository
+ url: https://maven.pkg.github.com/octocat
+ token: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+```
+{% endraw %}
+
+#### `npm-registry`
+
+The `npm-registry` type supports username and password, or token.
+
+{% raw %}
+```yaml
+registries:
+ npm-npmjs:
+ type: npm-registry
+ url: https://registry.npmjs.org
+ username: octocat
+ password: ${{secrets.MY_NPM_PASSWORD}}
+```
+{% endraw %}
+
+{% raw %}
+```yaml
+registries:
+ npm-github:
+ type: npm-registry
+ url: https://npm.pkg.github.com
+ token: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+```
+{% endraw %}
+
+#### `nuget-feed`
+
+The `nuget-feed` type supports username and password, or token.
+
+{% raw %}
+```yaml
+registries:
+ nuget-example:
+ type: nuget-feed
+ url: https://nuget.example.com/v3/index.json
+ username: octocat@example.com
+ password: ${{secrets.MY_NUGET_PASSWORD}}
+```
+{% endraw %}
+
+{% raw %}
+```yaml
+registries:
+ nuget-azure-devops:
+ type: nuget-feed
+ url: https://pkgs.dev.azure.com/.../_packaging/My_Feed/nuget/v3/index.json
+ token: ${{secrets.MY_AZURE_DEVOPS_TOKEN}}
+```
+{% endraw %}
+
+#### `python-index`
+
+The `python-index` type supports username and password, or token.
+
+{% raw %}
+```yaml
+registries:
+ python-example:
+ type: python-index
+ url: https://example.com/_packaging/my-feed/pypi/example
+ username: octocat
+ password: ${{secrets.MY_BASIC_AUTH_PASSWORD}}
+ replaces-base: true
+```
+{% endraw %}
+
+{% raw %}
+```yaml
+registries:
+ python-azure:
+ type: python-index
+ url: https://pkgs.dev.azure.com/octocat/_packaging/my-feed/pypi/example
+ token: ${{secrets.MY_AZURE_DEVOPS_TOKEN}}
+ replaces-base: true
+```
+{% endraw %}
+
+#### `rubygems-server`
+
+The `rubygems-server` type supports username and password, or token.
+
+{% raw %}
+```yaml
+registries:
+ ruby-example:
+ type: rubygems-server
+ url: https://rubygems.example.com
+ username: octocat@example.com
+ password: ${{secrets.MY_RUBYGEMS_PASSWORD}}
+```
+{% endraw %}
+
+{% raw %}
+```yaml
+registries:
+ ruby-github:
+ type: rubygems-server
+ url: https://rubygems.pkg.github.com/octocat/github_api
+ token: ${{secrets.MY_GITHUB_PERSONAL_TOKEN}}
+```
+{% endraw %}
\ No newline at end of file
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 dafdd7d9e58c..023771cbe11c 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 eb2944629f7c..2a8e4a235be4 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 8a3a1cde8cd8..010fbbcb586e 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 f42c9d2a9a30..4f05c5af5ae3 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 27105cdd2f2a..1060d920096a 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 8c100e064bce..309dca088f9f 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 95340f31d2d8..8d078b68fc26 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 77d1e3d332f3..1e5e81df5b9e 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 10a7cc56547a..beb609f0db98 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 ddf52fc18cef..584181f842dd 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 87e00bcbfc63..51abc910fb93 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 69b1689383e3..ea22b7c9f465 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 4027f7cfc16e..d7afb49e3005 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 4edba4ddedd8..e665938671d7 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 04f8ec9a6109..e84fe4da5c24 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 %}
@@ -18,9 +20,12 @@ You enable {% data variables.product.prodname_dependabot_version_updates %} by c
### Enabling {% data variables.product.prodname_dependabot_version_updates %}
-{% data reusables.dependabot.create-dependabot-yml %}
-1. Use `package-ecosystem` to specify the package managers to monitor.
+{% data reusables.dependabot.create-dependabot-yml %} For information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates)."
+1. Add a `version`.
+1. Optionally, if you have dependencies in a private registry, add a `registries` section containing authentication details.
+1. Add an `updates` section, with an entry for each package manager you want {% data variables.product.prodname_dependabot %} to monitor.
1. For each package manager, use:
+ - `package-ecosystem` to specify the package manager.
- `directory` to specify the location of the manifest or other definition files.
- `schedule.interval` to specify how often to check for new versions.
{% data reusables.dependabot.check-in-dependabot-yml %}
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 9937e192414f..0ec0ad3282bf 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 5ed179703c13..6c1ae358079c 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
---
@@ -64,6 +66,7 @@ versions:
{% link_in_list /enabling-and-disabling-version-updates %}
{% link_in_list /listing-dependencies-configured-for-version-updates %}
{% link_in_list /managing-pull-requests-for-dependency-updates %}
+ {% link_in_list /managing-encrypted-secrets-for-dependabot %}
{% link_in_list /customizing-dependency-updates %}
{% link_in_list /configuration-options-for-dependency-updates %}
{% link_in_list /keeping-your-actions-up-to-date-with-dependabot %}
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 4e6c7b54b8ef..212bf528ddf0 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 3c6c79af15ab..5b7076daa1b4 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 8d87615b86cc..b6cb7bbcba23 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 19a0c93aee15..5fb3ca1c6715 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 06a6d484d769..38384638d713 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 d6c7398e9837..e4495dda3460 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 8773a1704dca..0e7cb11f0f0e 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 2688f35f9e52..c59c70f2b284 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-encrypted-secrets-for-dependabot.md b/content/github/administering-a-repository/managing-encrypted-secrets-for-dependabot.md
new file mode 100644
index 000000000000..1362ff78668d
--- /dev/null
+++ b/content/github/administering-a-repository/managing-encrypted-secrets-for-dependabot.md
@@ -0,0 +1,72 @@
+---
+title: Managing encrypted secrets for Dependabot
+intro: You can store sensitive information, like passwords and access tokens, as encrypted secrets and then reference these in the {% data variables.product.prodname_dependabot %} configuration file.
+versions:
+ free-pro-team: '*'
+---
+
+### About encrypted secrets for {% data variables.product.prodname_dependabot %}
+
+{% data variables.product.prodname_dependabot %} secrets are encrypted credentials that you create at either the organization level or the repository level.
+When you add a secret at the organization level, you can specify which repositories can access the secret. You can use secrets to allow {% data variables.product.prodname_dependabot %} to update dependencies located in private package registries. When you add a secret it's encrypted before it reaches {% data variables.product.prodname_dotcom %} and it remains encrypted until it's used by {% data variables.product.prodname_dependabot %} to access a private package registry.
+
+After you add a {% data variables.product.prodname_dependabot %} secret, you can reference it in the _dependabot.yml_ configuration file like this: {% raw %}`${{secrets.NAME}}`{% endraw %}, where "NAME" is the name you chose for the secret. For example:
+
+{% raw %}
+```yaml
+password: ${{secrets.MY_ARTIFACTORY_PASSWORD}}
+```
+{% endraw %}
+
+For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#configuration-options-for-private-registries)."
+
+#### Naming your secrets
+
+The name of a {% data variables.product.prodname_dependabot %} secret:
+* Can only contain alphanumeric characters (`[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed. If you enter lowercase letters these are changed to uppercase.
+* Must not start with the `GITHUB_` prefix.
+* Must not start with a number.
+
+### Adding a repository secret for {% data variables.product.prodname_dependabot %}
+
+{% data reusables.github-actions.permissions-statement-secrets-repository %}
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.sidebar-settings %}
+{% data reusables.github-actions.sidebar-secret %}
+{% data reusables.dependabot.dependabot-secrets-button %}
+1. Click **New repository secret**.
+1. Type a name for your secret in the **Name** input box.
+1. Enter the value for your secret.
+1. Click **Add secret**.
+
+ The name of the secret is listed on the Dependabot secrets page. You can click **Update** to change the secret value. You can click **Remove** to delete the secret.
+
+ 
+
+### Adding an organization secret for {% data variables.product.prodname_dependabot %}
+
+When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories.
+
+{% data reusables.github-actions.permissions-statement-secrets-organization %}
+
+{% data reusables.organizations.navigate-to-org %}
+{% data reusables.organizations.org_settings %}
+{% data reusables.github-actions.sidebar-secret %}
+{% data reusables.dependabot.dependabot-secrets-button %}
+1. Click **New organization secret**.
+1. Type a name for your secret in the **Name** input box.
+1. Enter the **Value** for your secret.
+1. From the **Repository access** dropdown list, choose an access policy.
+1. If you chose **Selected repositories**:
+
+ * Click {% octicon "gear" aria-label="The Gear icon" %}.
+ * Choose the repositories that can access this secret.
+ 
+ * Click **Update selection**.
+
+1. Click **Add secret**.
+
+ The name of the secret is listed on the Dependabot secrets page. You can click **Update** to change the secret value or its access policy. You can click **Remove** to delete the secret.
+
+ 
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 a4bb51ee209c..f8f65c1c8014 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 ebe089535a7f..ed3277df69d4 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 fb779d9e7c55..0998c7252e32 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 fe7f46cdc3ec..d62b9d82b2e6 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 f652543a23b1..4eed68ffc836 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 9e38d3ccecc9..fc4dac076643 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 f165dc498635..ffa5b30e4a2e 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 94e4afbdf937..6d6be04cd204 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 372ed4cafcba..0ee087417a64 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 7b23d9d5d5a4..2386a1195483 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 49b2a1bb3015..57638a77a7d8 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 7f8ac645e7a3..52e4b9e21ead 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 73f4af51ea0a..357d9148e6fe 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 aacaffa8b605..587bf86a2936 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 95343d8a7a69..94388ad8a4ac 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 d07532b5f407..3424fb27b74d 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 ce60dccc84e6..f2c483980662 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 9c6758f8c145..d551f5f7556e 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 e11d111666d8..bc64774ab135 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 d36acb1003a1..f1f469fcb051 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 c7d1f21a1a11..1f3dad6026f9 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 bb6b3e730460..c7f6ff6491f3 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 4c518894911a..77a2b528cacd 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 0ffa4bb10aaa..1718f9d21c8c 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 e6d03cbea3ab..2eaef9677c1f 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 478630fc958a..fec3b375c202 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 4310af7d7191..0b15769178bc 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 e8c4ba5e23c0..6df4b4b162d3 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 668b00c955f6..0638c2432fa5 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 79bf3d46bf35..895402d67115 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 e1cc60930123..bd089ba9e756 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 6b52b6665894..f7d73042d11c 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 ee2b69a4b70c..dd401111ea62 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 dca4ac4c694c..6c32b4a44466 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 c2889d554737..b57c38d604f4 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 1ffc22df36a8..0abd12c197ef 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 9a95a12d6b61..1131f1f04eac 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 2e7403a50fc8..36d736bca8b4 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 937293a14352..ac377530660f 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 bc352f983e15..3066f68814ff 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 2f82f7db52d3..09ce32816e24 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 a0e789b8222e..5ffb4b5bf27e 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 aa7dc1332f9f..95d39a899a7f 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 eb78e0548668..2340dc543333 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 754ca8c949ba..db2e968ad7b2 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 a815793bf9cd..2d624157295d 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 6364fe62383f..334725eabb31 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 ad63b888c36e..0a0cf75aaf62 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 af70808b4358..c652063f7423 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 2e4c52a8bf33..91003389a05a 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 6057153d6bde..6c57fec292e5 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 f45e846a3edb..51660edaecab 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 dda09ea92a69..818e7dc7176e 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 3d9d3e3fad74..9699bf3bc702 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 1c844c383800..1d0e21375079 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 3ca153f2dfba..fadb01e5fd53 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 b02d4f0cefdd..65069037b2e7 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 020d609a12a9..93182ab5064b 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 309b4e69c182..6b47b5874f43 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 30e51c708783..d59e1b78c4d9 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 183fecb7f34f..f2cceaccef79 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 da61d7119659..1402793ca0f9 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 79c9518fac9f..80cf7fc05628 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 e3259b0eff4c..f6fad1ddb207 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 fc251cc1e1b6..e5bc1c00c689 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 55bd3a3601ca..95e6b04666d4 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 ce1fd85a5736..81cd79e7ff3d 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 6bbe5801e191..6423bac6f8ab 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 85eba969b973..f6b160dfd099 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 01aa0036e47e..466c990e1c88 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 ba3e70593d86..2aec1117d359 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 597dc2ed9677..5dc2e4fc18f6 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 fe4fefa5cb8a..247301e527b5 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 79240214457f..08026ad479d3 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 065f2c0582ba..a20303dd82d3 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 70780cac456c..5fab6b7ab93c 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 14137184345d..167a477bb5ba 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 eaf728188e2b..ae4ef0099ed5 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 6e0edc68220e..a7d35a006ebb 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 15a8a860a3c4..0d76efd0fca6 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 75214d3ae805..121deadaebc3 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 e215b0d4b566..f072a89dab7c 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 ba712f9d7389..05f7043e7878 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 4b3d9b9288ef..ce7b47ed3bca 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 81917a1cc175..859778b9ebb7 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 1e693282d9ad..f4a26afaa93f 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 5e1f3a28efdb..5876ae99d693 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 8d8c0a7b0e5b..7f3ecabf3e67 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 6e0beec462d1..39ebce9237a2 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 d145d7dd8311..2b20b15381a5 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 aa7d99e071b6..c83fcd680496 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 05d1c8941362..b69cd607cd25 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 62ae60514647..738e36f1ac99 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 7fb6d5701374..c16e886001ed 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 855f81f77799..7a4a51f99923 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 77ef77338a93..c2dc55ccef5f 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 3cd1846dba09..f8cc461171e9 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 13df72ab2737..d8686332e6b7 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 c4157ac34c3f..373b288d0e45 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 5e725a84aa9e..81a9895472f8 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 29ff88826283..a0098f30585f 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 1dc9587157ea..400b502f0e00 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 db5793db24a8..b65315103845 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 d592597dd6bf..57e1e83f5e01 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 95c92f2edeaa..54e3f5c09ac4 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 70d3a13506b8..96db2f19240a 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 6c01ed2e084a..b04377b01c3b 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 8c96c2630243..d43d4be7307b 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 da85594b43ba..3b7219a4c1bd 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 7f384471b5fa..2035ce49d211 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.amrom.workers.devmunity-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 5ace72549291..72e9dbb00a91 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 16acb1360ccb..9b41dd1009a7 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 de50df47daa0..2bbba1c9fe58 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 4dc421624336..790af089e248 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 8cb5adf5ce55..3a22ec0bd17b 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 6b02dc83f3b8..68955777c35f 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 e33cd7be4c1b..55703398796c 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 aca5e9c2ff24..c529f52f845a 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 4779c2e8c9f6..bab3c8d57f48 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 0af05d43554d..9ddaa0094d72 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 616b7024246b..f0b25a83de8b 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 f62dd1c2acbb..49e348174936 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 3435c8fa32ac..65848c631a4e 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 caaad4013d08..8af76dfd85ac 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 047ea789cc3f..27efafed8f6a 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 0f3bae172f3b..a5866bc295ae 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 14595a111af2..016cc6cc7ace 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 732530448233..f9cec4d87c58 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 7e07ded2be3b..10c3ea747512 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 8e21b6d214cf..c88963f9b016 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 c7acbb201e03..a98a7988d345 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 8e10ed8b964c..620828529ab0 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 140097bc99b6..7c0a21518074 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 cd9d14482481..93a6a0374d24 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 ffba2f58cfda..e157d032a519 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 4723d04971af..cf4fb304a9ec 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 496b92edd073..bc9829b98f01 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 e84de9cf65e9..45d42c07a0eb 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 a6854818c402..04caa5fe3649 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 3cfba312473c..12d2eb2b926e 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 2e5cf86f52c8..dc5773a4dd92 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 c8c46903c489..5684ef55c057 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 4ed1a97a601a..edb7dbdb90a2 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 a6acb76c97dd..cfb5b3c97248 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 e185d0a0cf41..1d4bdbd22315 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 2f109a79d619..d40da420da68 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 0f38fb1a00cf..fe0ffb4d7a43 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 357da89aedba..8808971cdc1e 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 0aebcf7f57e3..a6de47b3487d 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 501339a84f64..15326fe298e0 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 4f0c487c12a8..c7618f35075b 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 0f52e396f71b..9a7a0aacc579 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 8abfc72cb184..0f50ae18a7db 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 5b1ea925dc15..4fe786ab065b 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 b94297ab4418..9aceb77d6c04 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 0caba244c67b..d6d564c40990 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 68bcb96e4a6a..b8db6db125ae 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 1e666ca019af..51e6d1548537 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 876784f7cffb..ffac83495b20 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 4463aa1477b9..d74e66d01cf0 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 816072556fd1..be470cec0bc8 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 913990858c73..efe90d1598ce 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 65ebb3844c73..72ba7b1693e7 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 ec47c6933b68..a423d69817d8 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 5dae3a154053..f97a0aa9fbcd 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 dd7b4b5df1be..2eeeb21d67f9 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 83cbe9154986..f0b03a1aae2b 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 2f68164e6220..f925a1ee2368 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 efecceace8f5..0abbfff56244 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 affc3dd844ad..941f9b9da1e5 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 6beac4889529..7eab837b12df 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 28d3dee2e53a..563ad76cfb0a 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 fef659dd91ef..0fca472b8f20 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 3b9fb08f27e5..2df075cbef4e 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 51d0fc1e328c..829e7fffa77c 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 c9da88109fba..c65f2577a1e9 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 2e65dc8587e6..c11e0278a740 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 214d30606e25..87e8cbf1fd2e 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 94d1f82eb31b..2fde93a169bc 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 9e2fc6a4ec4f..722ababce542 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 bb9d9e01a712..39ef8ed46ef1 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 8a8f7b9bdf35..e7d866a63bb2 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 ac898cfee55b..8fd1c33c3f8d 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 8272d98dcb29..e8b70b558fdc 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 0dc66db59f6f..8014777ecb18 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 fbd4af8d7b03..bdf453d8424a 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 c8174a611ee4..a5cb8960238d 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 ca3e328a934b..ab4eaeb9cd54 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 39778d159c4d..786ce1022cc4 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 29b1a39280de..c02192cb3804 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 bff96eedc7c9..69243b563ca2 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 f1854f8be8ff..1f7017a371bd 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 55b0e571ce69..b5a1a1591ddf 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 5910f71320e3..8c1b1a9b6abb 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 d590e22a927c..c5b3fb896fba 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 0110416cc7c3..aaf80f4d9a78 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 0a5310093a9e..1ebf7e51a805 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 6bf832fcb67e..be9786624d19 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 22648b22421f..c7553618ce96 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 c711a287630b..133a2f95f3ea 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 07781dde1b63..0c63b670abf4 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 ff22cc9ec47b..11f694ab4101 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 db9fe05a45e3..3479d7ede0d2 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 a9df2f093fa8..f40aa202bc8e 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 1ec4ada1215c..c0a39439e161 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 a364ad30507c..1db7b63da34c 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 2843a272a729..f99fc17ff167 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 41c342082979..2aeb8deb0965 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 2539fd67627a..57ec686accf5 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 2daf7c260763..400c0391881e 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 cc973aea5e47..a190ef196242 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 64cedbedb9f1..084fc31a5389 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 93644fd98585..8599ca24b290 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 0e514fc25e32..5869a83fc04d 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 d8f88cd46b94..cac898efaf72 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 c54a30bb932d..26d431136039 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 b94bfc2fbaf2..dae62003f2f0 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 3f9ef7ac04ec..99dabb5999a9 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 cf5bc1721e5c..3b6825a2dbdb 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 ee5e4671d591..a463ffdbf6ee 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 a05a2ca34942..004c326f7914 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 b2ff31219a8e..511d7205cd92 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 eb3de3852583..8bdd7005a85b 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 e7659aeb0920..fb199b31c068 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 %}
@@ -31,8 +33,8 @@ You decide how to generate {% data variables.product.prodname_code_scanning %} a
{% data reusables.repositories.sidebar-security %}
3. To the right of "{% data variables.product.prodname_code_scanning_capc %} alerts", click **Set up {% data variables.product.prodname_code_scanning %}**. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}If {% data variables.product.prodname_code_scanning %} is missing, you need to ask an organization owner or repository administrator to enable {% data variables.product.prodname_GH_advanced_security %}. 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)" or "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %}

-4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow.
- 
+4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow.
+ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Workflows are only displayed if they are relevant for the programming languages detected in the repository. The {% data variables.product.prodname_codeql_workflow %} is always displayed, but the "Set up this workflow" button is only enabled if {% data variables.product.prodname_codeql %} analysis supports the languages present in the repository.{% endif %}
5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow.
Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing.
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 496acb280221..1d93129def8a 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 6a37da5f57d9..7fb5107e44cf 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 5e1f031769f0..b88ddd1e4fad 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 a8908896f78c..d8b31a696854 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 942e66060bc4..685e815aeac8 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 b828445961db..f524f975c777 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 2ac9ca9b92c6..16bb315d08f7 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 f4e1f7ed5365..89ae0113f8b0 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 b2483b1986ea..bd8b6a4f518b 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 d326445068bf..2817ef122eea 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 e04f4e2030d5..94477e922cf8 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 caee1aa1ebf5..595962f3c5ec 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 796214bfb518..86b64226f473 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 6d85fbd4f0d8..c9bba505fd13 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 d1b5e3c6c9a4..46760bbc0700 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 cbf380c4a01c..c629d1875126 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 74914f4ea55f..777773290a11 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 9abdb3615951..ff68b7c922cf 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 bce85ea84e85..cfb8affbb716 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 1a0fc38c537e..13e74967423b 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 4f14fddd35c5..8a162bbf28a2 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 f3f4596e9eb9..184a5a0296c6 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 8c94a8491f1c..d43ab528ff7c 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 77de003bdf25..d123093cb0ce 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 993595cb4ebd..2cbf15688c38 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 3e1169f8e418..e96c3b8490ca 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 46ae74fe246d..3105c872d258 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 d0d75deba76d..8800cbbc3fd1 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 f30f4968829f..fa3b49af1444 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 540b8e845c80..b231d472ab1a 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 17235a24551f..f1615b90b777 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 f4a31c5d3591..71f4415c438f 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 c203f9b71da1..f1b6595e4a0e 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 2f0fc63c9abd..b4ec09487fd7 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 2b87bdf54e4f..62e57a8f867c 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 4f625eff349a..9f3b073d396b 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 40bcfcc02ef0..163a2a447b08 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 dc10c8e09f9e..21cf61f24519 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 5de63217e7dc..94bebe636ab2 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 756ff937e075..e1e9942b6145 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 faf07b3fb458..c17ebfd9e914 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 da52349c22ee..847cc2c4f7c9 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 1badad1949c8..4e9a2a76e52c 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 863ba4e52d30..909b0152ec7e 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 7479f992315a..cdabc716cb65 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 c628d6408075..4a1f31ec2e33 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 82b3f3ecc817..693ce8c7cfd4 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 213d83c12459..3477c51b8089 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 c516722bcb0e..6b9520034047 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 5f4a5868b0ca..cbb171c5b3c2 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 216d9abe4f12..426afc055d4a 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 1f3c59ad2082..2a547a058b38 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 5e13b3f24ad1..11567a5abde9 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 99fb0d7b548d..9ace4fd76b17 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 be3704331a5c..60e0292cb6d0 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 2fb771ab505a..2632f39bf457 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 1fdc4431660d..34402e25b6a4 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 932ce92e86ff..c5b8113b3a4f 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 f1c2841e3b32..4ddb6196d254 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 9041daa8dee3..2d5b72356abd 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 c18203564881..eae7a3aedc46 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 874073caaa9a..1b0d31f33cbc 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 a45c3564bf71..12d047bb37e2 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 fb5e8e5a9568..b4961194c48f 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 c1ae6ff87fc5..55c9e8a0b5c1 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 b1097a9342eb..c89422243973 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 fd713c6afb5d..983020feecc8 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 d2914ae576f9..c60b339d43ca 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 9afde0213a9a..ee2fd3d8ae14 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 85d0c898bea8..145fe1516d03 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 a69030e7e26d..80d91731a948 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 cde49eaca02c..511a9bff695a 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 ff06ba0cb0d3..d3e2fbfb3d18 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 5d9f2b85c4ed..fa7dcb49d727 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 %}
@@ -76,9 +78,20 @@ There are separate limits for security and version update pull requests, so that
The best way to resolve this error is to merge or close some of the existing pull requests and trigger a new pull request manually. For more information, see "[Triggering a {% data variables.product.prodname_dependabot %} pull request manually](#triggering-a-dependabot-pull-request-manually)."
-#### {% data variables.product.prodname_dependabot %} can't resolve your dependency files
+#### {% data variables.product.prodname_dependabot %} can't resolve or access your dependencies
-If {% data variables.product.prodname_dependabot %} attempts to check whether dependency references need to be updated in a repository, but can't access one or more of the referenced files, the operation will fail with the error message "{% data variables.product.prodname_dependabot %} can't resolve your LANGUAGE dependency files." The API error type is `git_dependencies_not_reachable`.
+If {% data variables.product.prodname_dependabot %} attempts to check whether dependency references need to be updated in a repository, but can't access one or more of the referenced files, the operation will fail with the error message "{% data variables.product.prodname_dependabot %} can't resolve your LANGUAGE dependency files." The API error type is `git_dependencies_not_reachable`.
+
+Similarly, if {% data variables.product.prodname_dependabot %} can't access a private package registry in which a dependency is located, one of the following errors is generated:
+
+* "Dependabot can't reach a dependency in a private package registry"
+ (API error type: `private_source_not_reachable`)
+* "Dependabot can't authenticate to a private package registry"
+ (API error type:`private_source_authentication_failure`)
+* "Dependabot timed out while waiting for a private package registry"
+ (API error type:`private_source_timed_out`)
+* "Dependabot couldn't validate the certificate for a private package registry"
+ (API error type:`private_source_certificate_failure`)
To allow {% data variables.product.prodname_dependabot %} to update the dependency references successfully, make sure that all of the referenced dependencies are hosted at accessible locations.
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 ce6fe1bc8eba..91aac50f13b6 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 532fddecb57e..c1c2a5ea52c8 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 90e0dd0d9951..3c83e172308a 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 b10f85762d35..e7b5a97ca3e6 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 64f25bd77b44..d6ab24841471 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 8a458d1456c1..bfc6a6038a21 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 ed54e4ee58c3..2ac3e96335c1 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 5e5c8949b4f5..506a577ecfda 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 57f54410c0a4..4783be44f1ab 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 d947f274cb93..41501f058e33 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 ba87f0c7c00f..7995dcba5017 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 a6210db1b2d4..6214d8b1ea8b 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 761e8487ea03..1d23e517b8be 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 fa4321a74308..bdc6a0d93bd3 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 39b913c7c21c..010c9aea63bc 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 1a6b04071ace..1fcade4aa091 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 f1b544a09405..9f7ec04b6891 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 95004080719a..fee3c09c34ea 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 27238a9b7314..2b3ae8c27fd8 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 da22dbe57969..69c4caa8fcca 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 250c4684a9e2..d0407d4813ab 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 028e0c50317c..89d954f6b88e 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 87761cc8b8e4..1361bcea6321 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 cc7eb1dd665b..b6b513b8cf80 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 c9feda552b31..d3704545bb0e 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 73f110edabfc..2b6bc1cbda98 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 0ecd5477f465..34b68877bd76 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 57b8586d7121..5d0f001f7076 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 037b6efa7c6d..7289b952f4e3 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 1d7225e79e9c..6b6f7afefc52 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 283530bf8d14..f8f251b394ea 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 77f01938821a..4d4021f5a2fc 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 bd2ff8d5a3ec..b0d3ea02a83a 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 0524cf92373c..d8e3ae3338a9 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 365d7a03bc48..edff31371e7e 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 705f41ff5a38..0a087f1297a2 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 469bd2bac89e..eb8ea5c679ec 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 5a3d679fd65d..c6d697076853 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 6b5579d3b658..e944f2866f78 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 0f9e5c977cae..e9cc53d326d1 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 4abe40a38fae..abb1ae4b480a 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 a4a1ee3f6f88..4b1a22b3bea5 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 e04db9f3124f..e39fd884ff38 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 d0ad982702d1..33f6798afe79 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 d6c96b95d776..4f6d7d3eca1d 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 8459b5dd4d79..a59627be7d01 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 58bd074a17c7..1d633e08f3e2 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 ccc776aa0ec7..d90d3de26137 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 eb501619b014..a425a1a41154 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 e99658d64f03..b41b7ab75f99 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 e394df5c3192..ee6c96473213 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 09e093c6b8f6..99a825c4587b 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 4ecbcf476f6b..ccc1c55316de 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 7627c87e95ca..b8e75175134e 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 64b72de5fd3b..644415774ac1 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 583221530da0..9b07c631a251 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 6786f5add270..4b8baf8b8579 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 4ddda31852d3..17939004ef37 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 deaa2e4d84e6..8575fb7e8006 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 0137ba5be29c..9decbf89e353 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 dd4915bbee4c..6eb703d108e0 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 289f06851cee..081bd66cfdeb 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 6bdc39989500..9ad7f25801ac 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 64920e08156e..d7c5ba7a59a2 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 102296457cb0..68aac842f190 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 289597f46baa..0a5c9f90ddfb 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 0fc56efbff2f..a67a14142942 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 6205d243d610..39e04339714b 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 39c71d8a5b90..44c994ea1b0a 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 20e42320775d..df48291d6e81 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 b5f1b9d22b90..6206ebfb82a5 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 75b823525a9f..b29b41a6b216 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 e95408d57602..d5c9601adde2 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 f03e26fb17a1..41c64e585a21 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 a2fe749c4b3f..fc7c3da23789 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 5e4097328f87..748513265909 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 908a5b758fb9..5ec6be82f403 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 f66b04b94e24..081ea49f5829 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 8521b5faaa59..95b23ef0c283 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 00f94f10b15b..4adaa018637c 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 1ee2d6f95ed4..81750680373b 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 26639b46a16b..add2f14613ea 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 99cab36c6673..d56c5390ffaa 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 325fe570e9fa..6cd812eb6f11 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 20e4ea13be2c..121f4d8949b4 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 63a87f4ea828..cca11dff2466 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 1ef53215997e..c43385c2be2c 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 9f0908220511..dc1b05d6fe17 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 7abf04ebd901..84f966fe47e0 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 ee973ad804cd..eb9ad6bc366f 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 99af79b584e4..2a0027703f10 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 ae029cc60bb1..9c5932d9e16f 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 1d3fa8d063ac..590bd13680da 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 f5cb3931230f..19604added3d 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 8b377b21e1d9..42a40a8e55f0 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 e60a2c91ffb5..732af53a9225 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 620bb92d7cec..7528a07c8612 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 4ad2ca3d401f..88e02ca78866 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 978c3847963a..3f9b26120639 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 2252335a71f7..dbdcb5afdd62 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 8ea7be345db5..56f1b4762917 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 be7799346d2a..69126ef59bfe 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 c1743cd9df29..c68cc1fd9920 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 4f1306773faa..171d6f100310 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 4d9595814cb5..55d99d1503bc 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 8ae009055028..d297c4ee399d 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 0ee8629d6351..b9c50ec438f8 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 52e4c319e30a..cbc71c572fa0 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 28dcc69c66b8..5ee620bf4b20 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 d96469992f48..486292fcdda1 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 8e2bf2e7ccab..bca4ee43524b 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 39f30888886a..b8c8c8f629c6 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 3f00310c38f6..8eec46d9b362 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 18f10a288ac2..4842c9eb73fe 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 f03d1f05d65e..9b58bc52960e 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 929708d3eaae..c9ca0b8cc978 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 6af70a3655a1..c10dea733a62 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 e684dad17cf1..1f9507019272 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 0640df74bb83..5c60d891b541 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 250aaab93aa3..e5fa4995f3d1 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 7ba2f817258b..038f5af6559c 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 d28d8cb4be5b..4487393f5afc 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 95f32e829cc5..77eb7a316689 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 f2ed48d2f9b6..66a29895eefc 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 a2d2fb3b7dfa..ffe4d5ed49c7 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 f76f433b3aaf..e0951dd49fd0 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 bc7968d21ebe..06d264a1badd 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 cd65d50f26b1..71d7d250f8c7 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 19dd20d6d311..cfaee9f15b6a 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 a92f60b0396a..6ff83d7659c7 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 47f0471d8d5a..b6647fe927c5 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 782a9b2f4ada..848bdc0cf102 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 260b634f81f7..deef9231ef40 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 10f786b60db2..71811a02e0cf 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 1c16ae50efe0..a9614ba2a46a 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 6b3107ffe5fc..3e9d1d052a7e 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 fcf65f1adaef..11fbf086b3d6 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 7f939cf84cc6..5b7e84b959ac 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 71591f0aefe8..a04c0218532b 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 624a03a8856a..154855ba6837 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 5da63c8dc825..4122072bda34 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 308abb2d5f46..9b777b5eeebb 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 0fbcbda6bafe..36f06c238717 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 1b57c0922cc5..a61f9370d584 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 6bf572b9e9ec..d95bfccf0860 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 6d56d44867e1..aa9b95d1fd66 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 d75c5114c7f0..d061e78d3aba 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 fe9be4889c25..c2c416383af0 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 22f71d1f178f..daa42f63eba6 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 684e4a4f3170..6cea7ad0bd19 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 a3107304bdf9..cbddd686f4bb 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 7a1580b75f49..f9ae9677a050 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 f7b11a7a0f33..0332b57bcf81 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 b548094db847..3af305e77724 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 95eaedc29630..e1152db89d97 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 e38a631a7fef..66a47afe1f7a 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 3a68f66481f0..9c994b188472 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 8396a30e6491..f228264ab79c 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 6e719b47eddb..27a51a313a89 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 0725241ec2a2..221fd32ac765 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 81cb2611c51a..2e14f7e102c6 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 d72bc2ee197c..262113a3a32b 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 1db374fdc180..790a56e10421 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 d73f270e574d..6e4d1b4eed35 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 6e17a6cece58..cb4c12309f1c 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 2f3434282732..effe8a36c813 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 4ff72e431c0b..967d47bdf419 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 ab1ebbef7450..1196bdc9b325 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 ebda3d0ae055..c706237e944c 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 f06589eb3397..f12e2987df7b 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 5e15884e40c1..0d2f02074d3f 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 55a11392c520..81ece0d1b237 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 544e7396b580..1caafa06b986 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 d1d3d1b650b6..db638bafff25 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 0481b6502b14..968a93eef7db 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 d29be64dc932..4bba443eb876 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 bee8b07a10a6..5509cc6d9869 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 d483f8554c4c..ab490ccd8f4f 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 0463ce5199d4..f83e8694c7c6 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 ed149595e0f0..0cd884602737 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 be683104337d..d21c9c8b6fef 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 e4d9e8d55af1..99b423896d79 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 bebfbbc2d9aa..fe2af113793d 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 ba567880e8f5..7397639d749b 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 7de1e9bcd780..8f3fc489a178 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 afb7f66b0cd9..adc8f1782743 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 d331a4ca1225..08241fc58b49 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 24808059f5a3..5153f6a357e2 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 c0353de939ba..80c5ff684858 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 a51df67c9832..70a9607bb905 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 0c7304d050bc..7f2c029ce427 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 ae816c4de75e..62b65b07ce1b 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 32645337654a..76c0456caa9c 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 5d7ab225fdd9..b15db3e0cc9b 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 09b911c5fedd..722baa5e9d4f 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 cd5110e35f1f..2bdeee363128 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 b6a9fa4057ea..ed1fe22a090e 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 197bdfc5bea4..7b77503d4f33 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 cd5207d10275..314157419443 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 194b8f4c9a08..f7dcde666d3a 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 4cd31df71aeb..f16c843a4eff 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 750351b231e5..3ba913f22993 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 cd54ddd0c96f..7ec3f9f8c417 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 7f6719b4f8ba..59557ff8e96b 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 168400ecde94..0070b8eba7f2 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 507ee1d40507..497c8251f988 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 18cf027e387a..64b002f6bf55 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 f21057f972eb..9d14684e9134 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 99753ae9e23d..f39fa938c3d9 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 93269f99c484..1d046ad5ee0d 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 1be6eb078748..be3b2ef9c028 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 fb2dfb5b825d..61d86f76ab4a 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 %}
@@ -94,13 +97,17 @@ You can enable or disable features for all repositories. {% if currentVersion ==
{% if currentVersion == "free-pro-team@latest" %}
-### Allowing Dependabot to access private repositories
+### Allowing {% data variables.product.prodname_dependabot %} to access private dependencies
{% data reusables.dependabot.beta-note %}
-{% data variables.product.prodname_dependabot %} can check for outdated dependency references in a project and automatically generate a pull request to update them. To do this, {% data variables.product.prodname_dependabot %} must have access to all of the targeted dependency files. Typically, version updates will fail if one or more dependencies are inaccessible.
+{% data variables.product.prodname_dependabot %} can check for outdated dependency references in a project and automatically generate a pull request to update them. To do this, {% data variables.product.prodname_dependabot %} must have access to all of the targeted dependency files. Typically, version updates will fail if one or more dependencies are inaccessible. For more information, see "[About {% data variables.product.prodname_dependabot %} version updates](/github/administering-a-repository/about-dependabot-version-updates)."
-By default, {% data variables.product.prodname_dependabot %} can't update dependencies that are located in private repositories. However, if a dependency is in a private {% data variables.product.prodname_dotcom %} repository within the same organization as the project that uses that dependency, you can allow {% data variables.product.prodname_dependabot %} to update the version successfully by giving it access to the host repository. For more information, including details of limitations to private dependency support, see "[About Dependabot version updates](/github/administering-a-repository/about-dependabot-version-updates)."
+By default, {% data variables.product.prodname_dependabot %} can't update dependencies that are located in private repositories or private package registries. However, if a dependency is in a private {% data variables.product.prodname_dotcom %} repository within the same organization as the project that uses that dependency, you can allow {% data variables.product.prodname_dependabot %} to update the version successfully by giving it access to the host repository.
+
+If your code depends on packages in a private registry, you can allow {% data variables.product.prodname_dependabot %} to update the versions of these dependencies by configuring this at the repository level. You do this by adding authentication details to the _dependabot.yml_ file for the repository. For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#configuration-options-for-private-registries)."
+
+To allow {% data variables.product.prodname_dependabot %} to access a private {% data variables.product.prodname_dotcom %} repository:
1. Go to the security and analysis settings for your organization. For more information, see "[Displaying the security and analysis settings](#displaying-the-security-and-analysis-settings)."
1. Under "{% data variables.product.prodname_dependabot %} private repository access", click **Add private repositories** or **Add internal and private repositories**.
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 d6800f974954..c1659ebf20ac 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 54c73b2ab538..dca7e05e674a 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 9688d5223db5..afbdb5dfe0ec 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 97b52e84e989..d0c412bd3863 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 aadb68e9f9a2..2ea17240104e 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 1a56221145b1..d0c4ef8fe63d 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 184d6d2537f0..77d90558d2e7 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 f60a66464441..d849f0d8b86f 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 9a2b443b6994..1d363a5cc7d3 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 3a9dfef8fdf7..47a3e880a4ad 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 7941a9989c33..ccaaf3494e70 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 5229466db2f0..7ffab5946c1e 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 fc2ca3c1f7a9..b820de8bd849 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 cb15b03a45c0..8aa3341d1b17 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** | | |
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 77726b13994a..42459e82a65f 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 8302c0736736..c94b18983388 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 4faf9c67987d..8c14803057af 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 21d310302975..c774786ca2a2 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 7a8d714fa5dd..5df6e4477fdb 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 3608669ae51d..042cca36ba7e 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 16b4fb64bbb2..cc855248da79 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 69be72a9b536..27a9d304b210 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 545cc8145f2e..8dfd92496eb3 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 d46382fc5562..434d773e9509 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 832ccf3cf584..a5f65d7e7268 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 87ec11f1c209..5407d12da319 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 8df660190981..333b94a9dc0b 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 a0f04df3b932..05a0ab068599 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 cdc27e3eaf7c..8c7fc9d07f29 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 82391df28140..26a741bfc4a2 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 2f295775c4b1..df965d01f5a4 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 81fb510f8f27..cb8e427fcfb9 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 a5156b07c5d5..e85083f73643 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 6e0924546a21..75f20036b2ed 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 1a23b5fc5c5a..8c3dd0b4e015 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 b2e853ee7386..0e9ff0ecdead 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 d8e83edc9d38..dfcc61501b4e 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 ac62de20d3b2..9250fa7013eb 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 10d1f5c9aa83..64daf7b01f94 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 e70f55bc64b2..118d2a24a536 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 8634dc39ecd7..aaa629acd20a 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 6e9c8a766802..522a15d7f51e 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 2729775095f3..e22599de910e 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 af65c97cedd6..b37dc6cb9572 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 8cb3565f9162..1fc1cea56206 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 95b65b7aea3c..2d8302bb1d3c 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 db0098a2c97c..2aaf1817202d 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 c323c79f0342..484baa617a04 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 4e18a1b3a658..ff3684792846 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 9e67d7430757..eda9a879d36d 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 dd257564d078..3b499d3b2603 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 3322d7a400d1..1135c386189e 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 056c66340804..92325c05beeb 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 9ffac5db1a01..f98b9981a560 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 893493f0008c..463ae9733960 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 2e1d9a2c7b9b..19fe6d4cadd1 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 b1fd95b8847b..a3ed7851eaa8 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 5284cd63a311..bf16b25a803d 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 9aeb15a046bf..51a4749ae6cc 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 0e002776cb8b..4743ba484e53 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 036f99a19831..e2333feeee84 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 7ef386c2ae98..99413f99b7a7 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 2b1f5bec092d..fc56be779aa0 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 f5e9e4c08272..c3becba29ac1 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 2b0f109f96c7..8271ab0077ba 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 6d95d38f9f24..cbe70eef285d 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 a0f04ad09c7a..e6f5d9129419 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 5f847dd348db..e25cf3136e9a 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 6a02ac8400cd..6596a04d4433 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 9045814fc600..64cb68fdcbbf 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 a8ce59ba5081..ef3f0b988af1 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 5b1ed4ce4892..1c3f9e78b555 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 6ccf673df352..b5a764d7bcbc 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 348926c13c18..143d0baadda8 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 8e2f45146e18..651e15af7b92 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 a0323d4f21e8..bc2568895a3e 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 27d125ccd8b9..1295569fe51b 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 a417a7df7885..96714ca44c29 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 8ec6200f48e8..79372cb9035d 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 3b1bdfe5b3c4..8ffa84213af2 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 b63394ccd3d8..4227e55e421e 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 d24531780060..452442dbdd27 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 d5b5bcbbf26a..0a158f8e1462 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 b2ba70604a67..6d98ca7dbf92 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 6a1a2d651a5b..529e65c64dd4 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 b6ef2bc55529..65df71a04335 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 e12a79ddba9c..54d688fdac36 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 9829c4a9accc..32ed768480bb 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 184538843350..b5cdcf579261 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 99905412a661..9ad1c756724f 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 a4fb392c7bd4..9f0ba1abbf14 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 a81413352bed..80ff1b97b7ca 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 a7fc39ffc84e..93f96972bb1f 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 c175ed7288f8..786fe7da858a 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 2620b225697a..08de8cfc3e6f 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 b03f183b7359..84d3bddd5799 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 26871dae111a..cb1ddd422ba8 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 56bc439f157f..8eb29afb7913 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 d02c1a7a1b98..f47c140a3b1f 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 c72f08f6d589..2ad2b2a46c35 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 923402231ba4..9bba3b05ed3a 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 a61ec05adb01..13dfbff92fc0 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 8140f491016e..08ec06aef581 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 7704249f86b5..c5e362db8d0f 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 9094888eaddf..73250f620d16 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 2073ac5e5ea9..b8177c6b3b96 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 352849bd5716..550c5b1f3b52 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 8d3b6a831b6f..ce6539cb9d5f 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 a01d52289879..9e18f58d24ba 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 4676b8aeaeac..eb7faf45278f 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 ea304c8f150b..223fdd8e9900 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 b53a647506f4..0b29ed669952 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 04633f58fd1b..7dcd5e60c27e 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 442ab7153d07..d28e5fb58a99 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 0524ab40ce48..b199768a7b0d 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 3e31dd28147a..fcbe11a0a4fa 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 80a10eb4a82e..37b22a88d8cb 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 0cb96a47546c..2284aaf64711 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 93091a6db3bc..609bb5e5a3df 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 6939ca2d0910..6882f942b34f 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 4906f2934fbc..1c52e2bd8118 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 d77c697386f8..8c834e7dad1c 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 5eda5de372d6..97cdce17affe 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 d9e43ab812c3..a438da5c1b30 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 34e08f88859d..a1aa21b439e5 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 5a5c84520df8..aec4a67b0fbc 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 0a90a82e5963..8b37bf683b1d 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 1ffc7304d170..c4a4c40a9f44 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 e43a3ba4e462..d29f41ccea87 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 efc2bc6f5848..c2ee6b124fdb 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 48115cd1c3a4..6fcfee0db7ea 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 3e366d76a8aa..6e5cb962778a 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 d6a14d6120ce..f878c2ad8024 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 c73627ff5d81..449c6d616ccf 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 0ed0d7ec1384..ff37a78d386f 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 48b68a79f86e..7c6d29ca795c 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 aff71cd6e934..a8cbb44eb894 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 0b66ee43c5e8..b78ee543f6da 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 97bff67a756e..0a63b700439a 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 1b570f1a8201..b329a301ed05 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.amrom.workers.devmunity-forum-code-of-conduct.md b/content/github/site-policy/github.amrom.workers.devmunity-forum-code-of-conduct.md
index edffc306ecac..aa9b32dd802e 100644
--- a/content/github/site-policy/github.amrom.workers.devmunity-forum-code-of-conduct.md
+++ b/content/github/site-policy/github.amrom.workers.devmunity-forum-code-of-conduct.md
@@ -4,6 +4,9 @@ redirect_from:
- /articles/github.amrom.workers.devmunity-forum-code-of-conduct
versions:
free-pro-team: '*'
+topics:
+ - policy
+ - legal
---
### Overview and Purpose
diff --git a/content/github/site-policy/github.amrom.workers.devmunity-guidelines.md b/content/github/site-policy/github.amrom.workers.devmunity-guidelines.md
index 3e82aa45b7f4..29faa59f3b5c 100644
--- a/content/github/site-policy/github.amrom.workers.devmunity-guidelines.md
+++ b/content/github/site-policy/github.amrom.workers.devmunity-guidelines.md
@@ -5,6 +5,9 @@ redirect_from:
- /articles/github.amrom.workers.devmunity-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 9139ffcb294c..da405f50f09f 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 af27d5a37d3b..70a7a11a20eb 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 9610d2f73e60..c52346dc6761 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 6e8c43ce0520..5145ee3b6c5c 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 9cfae9d2b9f9..1daaf9078e25 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 23c272373188..830528e58a0f 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 b0129962bf8b..db08f7cc2f3e 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 70d4eb12aa38..a4b4d3fc5ea8 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 2e09b7646995..ce0de00a5658 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 d92ec43248da..1db55345588c 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 2d3b9ed20348..63e80b6c369c 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 4b2b6ba059f5..d6f59db4b78d 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 dc6f74153f9e..b9c0617da34a 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 7dbbaa9dc105..52c319b8e46a 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 69e4d996c882..f2afae3359a5 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 a28e956a51e5..f3c3a6cde94f 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 f16cccc3d9b1..cebfafa12d4c 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 343c68a35c46..060865d633ec 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 8d41be2fb7be..9ca2aa38b117 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 345953c1b991..c36e6115d198 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 183df800d6bb..77d9fc4fb54d 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 e2dd80c88adb..c1f4986beb6d 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 532399005d27..89ef4713f982 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 0fa984fdf792..4506d018c86f 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 492baa42d6ac..a9a8e8c8ecd8 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 67029fd81ebf..ec9f4459ed7e 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 78989d611256..63df89aedfb2 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 f045697c8302..d5639fc952c8 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 c2cef761609f..9d4e8b3ef8f5 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 34dd98fa5d5d..35a5ae50cf5d 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 d856dd5a122f..88c636f34485 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 003da8a970d5..567107b3e515 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 b3bb5af8c998..0169550a2d52 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 993701f37cae..f85f61fdfca8 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 f9b176f55d0f..f6d6dc0bd7e8 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 0cae836a8f2c..861e9dd6de33 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 640d96544813..5b8efe069cb8 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 53004b7463db..83b554458180 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 48892ef8f233..6623eceb6b0d 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 abfed9bd2c98..caa157285541 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 a4d3bdc206c9..1d9a6e18e3bb 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 ad0e8d461d65..2088f90c193c 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 f5271481a4bd..b068234cb2f3 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 02aec92e58a0..fb2a1f92f9f8 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 3d15b436627b..5a7e67412116 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 5b14699adcf3..6104ee4c0325 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 c51237a55cb2..c09ee905fb08 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 dd52943a774e..afbdabd06ac0 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 2f881fc29ab8..82ebe0fca012 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 20cf721790d4..79bd24bdcc85 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 6f402fa2851b..d8c5ccd8f1ae 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 91c7975d75de..0c50b6741727 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 33b5ccc1213a..15b3026ba41e 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 a04e1156146b..cbbff257f7a2 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 10a714d35b4c..d4ccc71ae235 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 c366f251c973..626cd9509e40 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 bf325418e092..b5f1e5716832 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 1bcc381a77d5..46548cb73aab 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 c78fdbcd3f2b..8dad33dd9953 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 bbe4472b6b44..a99330167585 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 efe4b1170c8f..0a0cc5f54e21 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 3159e6eab6d7..4ebccd26f227 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 2b091f486774..62b061ec2a40 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 9227b4a81dee..12a6d531854c 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 e9bfbbaf20a0..a5e0b266770c 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 5597ba968207..022031753d48 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 547d43123b47..36db23194d0d 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 512af56ba8ff..1085f9588278 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 6e91515f9288..e4df3a2b7f40 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 f846f7c24463..29cb2ecc6a67 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 71923497cc2e..fc1ad704c580 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 d472ee4b10d1..aaac77ac7d0c 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 8d2717705516..99062c6ee8f5 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 54505770e5e6..c7ffa5b0883e 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 26e7f87d1975..bf7966fab7cc 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 b61565f5a487..59a714c5d83c 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 03b0b70f083f..34fa16eaba11 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 e64b467d98c7..b4d87e69b1a7 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 a6857aa6eda6..bf7f5f5cb127 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 d8d0f6a57dd1..07106d9952be 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 2c570f5de45a..12d5e61d51bd 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 23e60f964671..3580a1e6b211 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 52661f89b412..da288d5eab6d 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 5b4d1ccac3c1..8fde3a5ee5f8 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 93c5e1e0d61d..aec7dde42f8b 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 b1ec8358fdfe..6f204fdb8aa3 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 283cb86b68ba..d24b5f19f731 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 132048eabb99..1c6c9279c0cd 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 22f7e9a64814..9d5eb1717f53 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 7fbd610e00a6..912cc52b6f77 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 f3dd9add8282..a68562a1cef4 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 37248a015847..82c8aa865b54 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 d99fa74258ed..88a7af7ff5d6 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 2fbdf674e3d6..412a41aeca4b 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 cfa20c4dc6f9..b548f03fccf2 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 1ea83fac6bd8..5e266237afef 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 f3fa8d849391..616b7929fdde 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 6824e7129319..aebd9103f9bd 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 35387642ba20..ca2df6f36718 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 542305f7cab0..7c4720043cf7 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 4f61114914ea..acb2035bf1e7 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 27493df1c5a1..f51a5ec5e3b9 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 0fb33e4920d5..80ef4ebd38ac 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 b0ebb7c5bcaf..705a2c3416b5 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 0c7b36f81be3..cb5eab5f5bc9 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 ba29ae3c09a5..6cdf450befbe 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 6c051b659f4c..3ecd22c955d6 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 74540b78a43a..b4d07c0939d4 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 d2a8c7309bdd..81dceae4a8f3 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 636fee5b9c25..4ca5ba3f6312 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 6272f17066c5..d653fad776f9 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 50ff25548cab..108b9b8be4cf 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 ad927ff2bbd6..35065838c79a 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 492e7b535c62..175ff95b3d40 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 387dcd51ac14..f523fd316886 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 7872b01baa65..c99b46cca64b 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 48b714cd4b40..208f468589d2 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 2863a61f0de0..8df4267a7821 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 2c9b6a786244..9b7381ec3faa 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 b9b21493b842..3aa637f5d78e 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 1cbc4cdb95d3..5613158c9828 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 c9bed981f33d..fc3a313eb27e 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 a084419a960b..77b0d8995632 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 b9ef899783f4..b5340295e873 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 51dde9700003..1c6177f34e07 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 e83f7ecde716..66e353a32805 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 f95f46749d5c..7ce9354f48fb 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 1313385db70d..2e5a47f87baa 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 bbdd90cbccd5..1e63a63190d0 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 1fb621b0b7b4..cbd50a3e8f80 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 9ee0ffc05009..50c89b4bdcde 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 5b760d18776c..5606e2030c6b 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 40b18ca6568a..02151bb9feb1 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 bae1b28804bd..8105ff975c4e 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 7e4de671cb08..287f95ae149f 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 b1a38139dcde..75cb6828c64f 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 ccbfff604691..25ece0fa28ab 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 cdd2e1188e98..9b38ae760b20 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 e641de8216ff..8020cfd01afe 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 0d6c7fb29b63..5344440e1d3b 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 a430cfd7be44..1b163b90f55e 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 507362958772..e8b3a6128803 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 ce3eed18cf69..ac89e3da37fd 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 %}
diff --git a/content/rest/reference/apps.md b/content/rest/reference/apps.md
index bb5f310f7db2..9238601e1ab1 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 e0ff6110c9c3..0fab2af1cd19 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 67ba813b87e5..3b1a680aa1e3 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 68ae532ae503..535217ba8cb5 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 50cb78757e7b..109bf9e92299 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 ea2ca0751dba..ec918c60c293 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 f5005e0fa261..eca5f8f968a0 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 1ff371cc244f..58d47faa7297 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 b7f6a6ffaa78..19e1c541ad16 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 21728e0dd33c..08f18a2449ea 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 3e0c064f4cef..88efef37c8c2 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 1fb73f9948c4..bce7ba6dfff3 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 d2bc96ed2198..f69333fbc548 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 080f5cba4359..3a67c0b3c8e2 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 5a71bd7804af..e9788767912e 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 b261f929a206..6cd6fa208356 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 f1709a3c8f94..c75353316f81 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 919098c4516d..45d9e1c36cc5 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 53450d887c54..36dc874017c7 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 25d9b5849552..9f6a813ca793 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 9ff76062b501..30b524f6e5f5 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 2009b2db269e..ebd99b432d94 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 01e09ecc01ac..6b744f26b43c 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 8992d9904953..7ddd930ec46c 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 b0bab1f317a7..19579cf814a8 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 fb032ed8980d..df50c65a890a 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 fc289eac2510..7de75572c36a 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 7223e949ec6a..7f6b2a3bf478 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 5371d5569c74..a8be9cb182d4 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 093a419341f3..46dece31140d 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 000000000000..a309eccd037c
--- /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 000000000000..ac4c83fe6d76
--- /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/8.yml b/data/release-notes/2-22/8.yml
new file mode 100644
index 000000000000..d1f7ca16f347
--- /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 000000000000..5090c38c5b12
--- /dev/null
+++ b/data/release-notes/3-0/2.yml
@@ -0,0 +1,28 @@
+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.
+ - In some cases after upgrading from a 2.22.X instance, the web interface assets were missing and the page would not render correctly.
+ 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 fc57d1e2da6d..2c0c30d196fd 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 000000000000..362868f66b88
--- /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 000000000000..fe2ce9b1874b
--- /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 000000000000..82be838ded2a
--- /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 000000000000..ecbd92717894
--- /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 1e61585baaf4..bbf085d6bf0c 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 f93772d5b744..ff72be9b61fc 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 000000000000..01e6a97f91d6
--- /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/dependabot/dependabot-secrets-button.md b/data/reusables/dependabot/dependabot-secrets-button.md
new file mode 100644
index 000000000000..1e46dd9f8a49
--- /dev/null
+++ b/data/reusables/dependabot/dependabot-secrets-button.md
@@ -0,0 +1,2 @@
+1. In the sidebar, click **{% data variables.product.prodname_dependabot %}**.
+ 
\ No newline at end of file
diff --git a/data/reusables/dependabot/private-dependencies-note.md b/data/reusables/dependabot/private-dependencies-note.md
index 18554c0ce138..7dd8f996d08a 100644
--- a/data/reusables/dependabot/private-dependencies-note.md
+++ b/data/reusables/dependabot/private-dependencies-note.md
@@ -1,3 +1 @@
-When running security or version updates, some ecosystems must be able to resolve all dependencies from their source to verify that updates have been successful. If your manifest or lock files contain any private dependencies, {% data variables.product.prodname_dependabot %} must be able to access the location at which those dependencies are hosted. Organization owners can grant {% data variables.product.prodname_dependabot %} access to private repositories containing dependencies for a project within the same 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#allowing-dependabot-to-access-private-repositories)."
-
-Currently, {% data variables.product.prodname_dependabot %} version updates doesn't support manifest or lock files that contain any dependencies hosted in private registries, or in private {% data variables.product.prodname_dotcom %} repositories that belong to a different organization than the dependent project.
+When running security or version updates, some ecosystems must be able to resolve all dependencies from their source to verify that updates have been successful. If your manifest or lock files contain any private dependencies, {% data variables.product.prodname_dependabot %} must be able to access the location at which those dependencies are hosted. Organization owners can grant {% data variables.product.prodname_dependabot %} access to private repositories containing dependencies for a project within the same 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#allowing-dependabot-to-access-private-dependencies)." You can configure access to private registries in a repository's _dependabot.yml_ configuration file. For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#configuration-options-for-private-registries)."
diff --git a/data/reusables/dependabot/supported-package-managers.md b/data/reusables/dependabot/supported-package-managers.md
index 6369d25a7559..d4929ca10a02 100644
--- a/data/reusables/dependabot/supported-package-managers.md
+++ b/data/reusables/dependabot/supported-package-managers.md
@@ -1,30 +1,30 @@
The following table shows, for each package manager:
- The YAML value to use in the *dependabot.yml* file
- The supported versions of the package manager
-- Whether dependencies in private {% data variables.product.prodname_dotcom %} repositories are supported
+- Whether dependencies in private {% data variables.product.prodname_dotcom %} repositories or registries are supported
- Whether vendored dependencies are supported
-Package manager | YAML value | Supported versions | Private repositories | Vendoring
---- | --- | --- |:---:|:---:
-Bundler | `bundler` | v1 | | **✓** |
-Cargo | `cargo` | v1 | **✓** | |
-Composer | `composer` | v1, v2 | **✓** | |
-Docker | `docker` | v1 | **✓** | |
-Elixir | `mix` | v1 | | |
-Elm | `elm` | v0.18, v0.19 | **✓** | |
-git submodule | `gitsubmodule` | N/A (no version) | **✓** | |
-GitHub Actions | `github-actions` | N/A (no version) | **✓** | |
-Go modules | `gomod` | v1 | **✓** | **✓** |
-Gradle | `gradle` | N/A (no version)[1] | **✓** | |
-Maven | `maven` | N/A (no version)[2] | **✓** | |
-npm | `npm` | v6, v7 | **✓** | |
-NuGet | `nuget` | <= 4.8[3] | **✓** | |
-pip | `pip` | v20 | | |
-pipenv | `pip` | <= 2018.11.26 | | |
-pip-compile | `pip` | 5.5.0 | | |
-poetry | `pip` | v1 | | |
-Terraform | `terraform` | <= 0.11 | **✓** | |
-yarn | `npm` | v1 | **✓** | |
+Package manager | YAML value | Supported versions | Private repositories | Private registries | Vendoring
+---------------|------------------|------------------|:---:|:---:|:---:
+Bundler | `bundler` | v1 | | **✓** | **✓** |
+Cargo | `cargo` | v1 | **✓** | **✓** | |
+Composer | `composer` | v1, v2 | **✓** | **✓** | |
+Docker | `docker` | v1 | **✓** | **✓** | |
+Hex | `mix` | v1 | | **✓** | |
+elm-package | `elm` | v0.18, v0.19 | **✓** | **✓** | |
+git submodule | `gitsubmodule` | N/A (no version) | **✓** | **✓** | |
+GitHub Actions | `github-actions` | N/A (no version) | **✓** | **✓** | |
+Go modules | `gomod` | v1 | **✓** | **✓** | **✓** |
+Gradle | `gradle` | N/A (no version)[1] | **✓** | **✓** | |
+Maven | `maven` | N/A (no version)[2] | **✓** | **✓** | |
+npm | `npm` | v6, v7 | **✓** | **✓** | |
+NuGet | `nuget` | <= 4.8[3] | **✓** | **✓** | |
+pip | `pip` | v20 | | **✓** | |
+pipenv | `pip` | <= 2018.11.26 | | **✓** | |
+pip-compile | `pip` | 5.5.0 | | **✓** | |
+poetry | `pip` | v1 | | **✓** | |
+Terraform | `terraform` | <= 0.11 | **✓** | **✓** | |
+yarn | `npm` | v1 | **✓** | **✓** | |
[1] {% data variables.product.prodname_dependabot %} doesn't run Gradle but supports updates to the following files: `build.gradle` and `build.gradle.kts` (for Kotlin projects).
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 144420eb2f7e..54d745b497b9 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 000000000000..fcf1b455c75f
--- /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 3af3da15cbb2..514e6e3e379d 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 6eb91edc1378..000000000000
--- 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 94535c20d34b..954c32fc7b23 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/notifications/vulnerable-dependency-notification-options.md b/data/reusables/notifications/vulnerable-dependency-notification-options.md
index 6fd66803d4e8..c85f038f8ab3 100644
--- a/data/reusables/notifications/vulnerable-dependency-notification-options.md
+++ b/data/reusables/notifications/vulnerable-dependency-notification-options.md
@@ -1,14 +1,26 @@
-{% if currentVersion == "free-pro-team@latest" %}
-By default, you will receive notification of new {% data variables.product.prodname_dependabot_alerts %}:
-- by email, an email is sent every time a vulnerability with a critical or high severity is found (**Email each time a vulnerability is found** option)
-- in the user interface, a warning is shown in your repository's file and code views if there are any vulnerable dependencies (**UI alerts** option)
-- on the command line, warnings are displayed as callbacks when you push to repositories with any vulnerable dependencies (**Command Line** option)
-- in your inbox, as web notifications for new vulnerabilities with a critical or high severity (**Web** option)
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.1" %}
+{% if currentVersion == "free-pro-team@latest"%}By default, you will receive notifications:{% endif %}{% if enterpriseServerVersions contains currentVersion and currentVersion gt "enterprise-server@3.1" %}By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %}:{% endif %}
+
+- by email, an email is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**Email each time a vulnerability is found** option).
+- in the user interface, a warning is shown in your repository's file and code views if there are any vulnerable dependencies (**UI alerts** option).
+- on the command line, warnings are displayed as callbacks when you push to repositories with any vulnerable dependencies (**Command Line** option).
+- in your inbox, as web notifications. A web notification is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**Web** option).
+- on {% data variables.product.prodname_mobile %}, as web notifications. For more information, see "[Enabling push notifications with GitHub for mobile](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)."
+
+{% note %}
+
+**Note:** The email and web/{% data variables.product.prodname_mobile %} notifications are:
+
+- _per repository_ when {% data variables.product.prodname_dependabot %} is enabled on the repository, or when a new manifest file is committed to the repository.
+
+- _per organization_ when a new vulnerability is discovered.
+
+{% endnote %}
You can customize the way you are notified about {% data variables.product.prodname_dependabot_alerts %}. For example, you can receive a weekly digest email summarizing alerts for up to 10 of your repositories using the **Email a digest summary of vulnerabilities** and **Weekly security email digest** options.
{% endif %}
-{% if enterpriseServerVersions contains currentVersion and currentVersion ver_gt "enterprise-server@2.21" %}
+{% if currentVersion == "enterprise-server@2.22" or currentVersion == "enterprise-server@3.0" or currentVersion == "enterprise-server@3.1" %}
By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %}:
- by email, an email is sent every time a vulnerability {% if currentVersion ver_gt "enterprise-server@2.23" %}with a critical or high severity {% endif %}is found (**Email each time a vulnerability is found** option)
- in the user interface, a warning is shown in your repository's file and code views if there are any vulnerable dependencies (**UI alerts** option)
diff --git a/data/reusables/organizations/team-discussions-are-for-orgs.md b/data/reusables/organizations/team-discussions-are-for-orgs.md
index e2d91927873a..cb0f53f8ed6e 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_run_desc.md b/data/reusables/webhooks/workflow_run_desc.md
index 8866577116c7..486a20dcd1d5 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/includes/footer.html b/includes/footer.html
index a74ee93eb220..d7477ba2da79 100644
--- a/includes/footer.html
+++ b/includes/footer.html
@@ -12,7 +12,7 @@
"
+ },
+ {
+ "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.
"
}
],
- "summary": "List releases",
- "description": "This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the [Repository Tags API](https://docs.github.com/github-ae@latest/rest/reference/repos#list-repository-tags).\n\nInformation about published releases are available to everyone. Only users with push access will receive listings for draft releases.",
+ "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/list-releases",
+ "operationId": "repos/get-readme-from-alt-path",
"externalDocs": {
"description": "API method documentation",
- "url": "https://docs.github.com/github-ae@latest/rest/reference/repos#list-releases"
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/repos#get-a-repository-readme"
},
"x-github": {
"githubCloudOnly": false,
"enabledForGitHubApps": true,
"previews": [],
"category": "repos",
- "subcategory": "releases"
+ "subcategory": "contents"
},
- "slug": "list-releases",
+ "slug": "get-a-repository-readme",
"category": "repos",
"categoryLabel": "Repos",
- "subcategory": "releases",
- "subcategoryLabel": "Releases",
+ "subcategory": "contents",
+ "subcategoryLabel": "Contents",
"notes": [],
"bodyParameters": [],
- "descriptionHTML": "
This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the Repository Tags API.
\n
Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.
",
+ "descriptionHTML": "
Gets the preferred README for a repository.
\n
READMEs support custom media types for retrieving the raw content or rendered HTML.
"
+ }
+ ],
+ "summary": "List releases",
+ "description": "This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the [Repository Tags API](https://docs.github.com/github-ae@latest/rest/reference/repos#list-repository-tags).\n\nInformation about published releases are available to everyone. Only users with push access will receive listings for draft releases.",
+ "tags": [
+ "repos"
+ ],
+ "operationId": "repos/list-releases",
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/repos#list-releases"
+ },
+ "x-github": {
+ "githubCloudOnly": false,
+ "enabledForGitHubApps": true,
+ "previews": [],
+ "category": "repos",
+ "subcategory": "releases"
+ },
+ "slug": "list-releases",
+ "category": "repos",
+ "categoryLabel": "Repos",
+ "subcategory": "releases",
+ "subcategoryLabel": "Releases",
+ "notes": [],
+ "bodyParameters": [],
+ "descriptionHTML": "
This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the Repository Tags API.
\n
Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.
"
}
],
"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.amrom.workers.dev.deref.json b/lib/rest/static/dereferenced/api.github.amrom.workers.dev.deref.json
index 290e985a8269..22e6099f63ce 100644
--- a/lib/rest/static/dereferenced/api.github.amrom.workers.dev.deref.json
+++ b/lib/rest/static/dereferenced/api.github.amrom.workers.dev.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 11b1bbf94672..b30da5d436cb 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 5206af05c249..42599cedf793 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 9c8e31506973..a5df8416c8ac 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 8aaab6d84bcb..a6998a1b0d8c 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 a5ca44119ea2..ebf7fa61eae4 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 663a6c26ed22..2fff74101d2c 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 4fb966764aa1..c8fe35b94165 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/search/algolia-search.js b/lib/search/algolia-search.js
index e14b4e452409..4f415a9c5c09 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 05eb88ddc3b0..bde23b7f7e46 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 1a3e65f3198c..1a0d5db2b535 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 79ac651f83b9..3c253ae617a8 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 c430cc1b3a33..149ad4285a5a 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 9a6f43138c20..e98e7fe172ff 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/update-files.js b/script/rest/update-files.js
index 8b42275334f2..ee1fe7298517 100755
--- a/script/rest/update-files.js
+++ b/script/rest/update-files.js
@@ -91,17 +91,23 @@ async function decorate () {
}, {})
for (const [schemaName, schema] of Object.entries(dereferencedSchemas)) {
- // munge OpenAPI definitions object in an array of operations objects
- const operations = await getOperations(schema)
-
- // process each operation, asynchronously rendering markdown and stuff
- await Promise.all(operations.map(operation => operation.process()))
-
- const filename = path.join(decoratedPath, `${schemaName}.json`)
- .replace('.deref', '')
- // write processed operations to disk
- fs.writeFileSync(filename, JSON.stringify(operations, null, 2))
-
- console.log('Wrote', path.relative(process.cwd(), filename))
+ try {
+ // munge OpenAPI definitions object in an array of operations objects
+ const operations = await getOperations(schema)
+
+ // process each operation, asynchronously rendering markdown and stuff
+ await Promise.all(operations.map(operation => operation.process()))
+
+ const filename = path.join(decoratedPath, `${schemaName}.json`)
+ .replace('.deref', '')
+ // write processed operations to disk
+ fs.writeFileSync(filename, JSON.stringify(operations, null, 2))
+
+ console.log('Wrote', path.relative(process.cwd(), filename))
+ } catch (error) {
+ console.error(error)
+ console.log('🐛 Whoops! It looks like the decorator script wasn\'t able to parse the dereferenced schema. A recent change may not yet be supported by the decorator. Please reach out in the #docs-engineering slack channel for help.')
+ process.exit(1)
+ }
}
}
diff --git a/script/rest/utils/create-code-samples.js b/script/rest/utils/create-code-samples.js
index ddb1d7bf6cb7..0bee5f1bf7ed 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 000000000000..7829f629adf7
--- /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 000000000000..46a30ad849b1
--- /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 3843e0abd735..988b278426f0 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 f61318d4c4d5..f6da35c32892 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 2c137527e62b..4046e0a66cb9 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 e328f846f0b2..982a72a086f7 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 000000000000..67e31554bba2
--- /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([])
+ })
+})