Skip to content

Commit a10c238

Browse files
sarahssarahs
committed
Merge branch 'main' of github.com:github/docs-internal into use-redirects-file-instead-of-stubbed-archived-redirects
2 parents ce54f74 + efb1edc commit a10c238

63 files changed

Lines changed: 22497 additions & 2766 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/ISSUE_COMMENT_TEMPLATE/status.yml‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
name: Status Update
3+
about: A brief status update.
4+
body:
5+
- type: dropdown
6+
attributes:
7+
name: Status
8+
options:
9+
- name: "GREEN \U0001F34F (All good, smooth sailing)"
10+
value: 'Status: GREEN'
11+
- name: "YELLOW \U0001F7E1 (On track, with hurdles to work through)"
12+
value: 'Status: YELLOW'
13+
- name: "RED \U0001F534 (BLOCKED)"
14+
value: 'Status: RED'
15+
- type: input
16+
attributes:
17+
name: Update Summary
18+
placeholder:
19+
Brief summary of the status and next steps. Any blockers should be
20+
called out specifically.
21+
inputType: longText
22+
- type: input
23+
attributes:
24+
name: 'Attribution'
25+
value: '_created with :heart: by typing_ `/status`'
26+
inputType: text

‎.github/allowed-actions.js‎

Lines changed: 35 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -4,36 +4,38 @@
44
// can be added it this list.
55

66
module.exports = [
7-
'actions/cache@0781355a23dac32fd3bac414512f4b903437991a', //actions/cache@v2.1.3
8-
'actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f', //actions/checkout@v2.3.4
9-
'actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9', //actions/script@v3.0.0
10-
'actions/labeler@5f867a63be70efff62b767459b009290364495eb', //actions/labeler@v2.2.0
11-
'actions/setup-node@c46424eee26de4078d34105d3de3cc4992202b1e', //actions/setup-node@v2.1.4
12-
'ruby/setup-ruby@fdcfbcf14ec9672f6f615cb9589a1bc5dd69d262', //ruby/setup-ruby@vv1.64.1
13-
'actions/stale@9d6f46564a515a9ea11e7762ab3957ee58ca50da', //actions/stale@v3.0.16
14-
'crowdin/github-action@fd9429dd63d6c0f8a8cb4b93ad8076990bd6e688',
15-
'crykn/copy_folder_to_another_repo_action@0282e8b9fef06de92ddcae9fe6cb44df6226646c',
16-
'cschleiden/actions-linter@0ff16d6ac5103cca6c92e6cbc922b646baaea5be',
17-
'dawidd6/action-delete-branch@47743101a121ad657031e6704086271ca81b1911',
18-
'docker://chinthakagodawita/autoupdate-action:v1',
19-
'fkirc/skip-duplicate-actions@36feb0d8d062137530c2e00bd278d138fe191289',
20-
'github/codeql-action/analyze@v1',
21-
'github/codeql-action/init@v1',
22-
'ianwalter/puppeteer-container@2466ba8ecf689ccf4e5dfadeff3ac2db227b2e17',
23-
'juliangruber/approve-pull-request-action@c530832d4d346c597332e20e03605aa94fa150a8',
24-
'juliangruber/find-pull-request-action@2fc55e82a6d5d36fe1e7f1848f7e64fd02d99de9',
25-
'juliangruber/read-file-action@e0a316da496006ffd19142f0fd594a1783f3b512',
26-
'lee-dohm/close-matching-issues@22002609b2555fe18f52b8e2e7c07cbf5529e8a8',
27-
'pascalgn/automerge-action@c9bd1823770819dc8fb8a5db2d11a3a95fbe9b07', //pascalgn/automerge@0.12.0
28-
'peter-evans/create-issue-from-file@a04ce672e3acedb1f8e416b46716ddfd09905326',
29-
'peter-evans/create-or-update-comment@5221bf4aa615e5c6e95bb142f9673a9c791be2cd',
30-
'peter-evans/create-pull-request@8c603dbb04b917a9fc2dd991dc54fef54b640b43',
31-
'rachmari/actions-add-new-issue-to-column@1a459ef92308ba7c9c9dc2fcdd72f232495574a9',
32-
'rachmari/labeler@832d42ec5523f3c6d46e8168de71cd54363e3e2e',
33-
'repo-sync/github-sync@3832fe8e2be32372e1b3970bbae8e7079edeec88',
34-
'repo-sync/pull-request@33777245b1aace1a58c87a29c90321aa7a74bd7d',
35-
'someimportantcompany/github-actions-slack-message@0b470c14b39da4260ed9e3f9a4f1298a74ccdefd',
36-
'tjenkinson/gh-action-auto-merge-dependency-updates@4d7756c04d9d999c5968697a621b81c47f533d61',
37-
'EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575',
38-
'dorny/paths-filter@eb75a1edc117d3756a18ef89958ee59f9500ba58'
39-
]
7+
"actions/cache@0781355a23dac32fd3bac414512f4b903437991a", //actions/cache@v2.1.3
8+
"actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f", //actions/checkout@v2.3.4
9+
"actions/github-script@626af12fe9a53dc2972b48385e7fe7dec79145c9", //actions/script@v3.0.0
10+
"actions/labeler@5f867a63be70efff62b767459b009290364495eb", //actions/labeler@v2.2.0
11+
"actions/setup-node@c46424eee26de4078d34105d3de3cc4992202b1e", //actions/setup-node@v2.1.4
12+
"ruby/setup-ruby@fdcfbcf14ec9672f6f615cb9589a1bc5dd69d262", //ruby/setup-ruby@vv1.64.1
13+
"actions/stale@9d6f46564a515a9ea11e7762ab3957ee58ca50da", //actions/stale@v3.0.16
14+
"archive/github-actions-slack@d368c5a4ad757515a9344918f84c490b05777d94",
15+
"ashley-taylor/regex-property-action@93a24f845cd20790924208225cc72da8b4c6d46d",
16+
"crowdin/github-action@fd9429dd63d6c0f8a8cb4b93ad8076990bd6e688",
17+
"crykn/copy_folder_to_another_repo_action@0282e8b9fef06de92ddcae9fe6cb44df6226646c",
18+
"cschleiden/actions-linter@0ff16d6ac5103cca6c92e6cbc922b646baaea5be",
19+
"dawidd6/action-delete-branch@47743101a121ad657031e6704086271ca81b1911",
20+
"docker://chinthakagodawita/autoupdate-action:v1",
21+
"fkirc/skip-duplicate-actions@36feb0d8d062137530c2e00bd278d138fe191289",
22+
"github/codeql-action/analyze@v1",
23+
"github/codeql-action/init@v1",
24+
"ianwalter/puppeteer-container@2466ba8ecf689ccf4e5dfadeff3ac2db227b2e17",
25+
"juliangruber/approve-pull-request-action@c530832d4d346c597332e20e03605aa94fa150a8",
26+
"juliangruber/find-pull-request-action@2fc55e82a6d5d36fe1e7f1848f7e64fd02d99de9",
27+
"juliangruber/read-file-action@e0a316da496006ffd19142f0fd594a1783f3b512",
28+
"lee-dohm/close-matching-issues@22002609b2555fe18f52b8e2e7c07cbf5529e8a8",
29+
"pascalgn/automerge-action@c9bd1823770819dc8fb8a5db2d11a3a95fbe9b07", //pascalgn/automerge@0.12.0
30+
"peter-evans/create-issue-from-file@a04ce672e3acedb1f8e416b46716ddfd09905326",
31+
"peter-evans/create-or-update-comment@5221bf4aa615e5c6e95bb142f9673a9c791be2cd",
32+
"peter-evans/create-pull-request@8c603dbb04b917a9fc2dd991dc54fef54b640b43",
33+
"rachmari/actions-add-new-issue-to-column@1a459ef92308ba7c9c9dc2fcdd72f232495574a9",
34+
"rachmari/labeler@832d42ec5523f3c6d46e8168de71cd54363e3e2e",
35+
"repo-sync/github-sync@3832fe8e2be32372e1b3970bbae8e7079edeec88",
36+
"repo-sync/pull-request@33777245b1aace1a58c87a29c90321aa7a74bd7d",
37+
"someimportantcompany/github-actions-slack-message@0b470c14b39da4260ed9e3f9a4f1298a74ccdefd",
38+
"tjenkinson/gh-action-auto-merge-dependency-updates@4d7756c04d9d999c5968697a621b81c47f533d61",
39+
"EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575",
40+
"dorny/paths-filter@eb75a1edc117d3756a18ef89958ee59f9500ba58",
41+
];

‎.github/workflows/post-status-updates-to-slack.yml‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
name: Epic Status Update
2+
on:
3+
issue_comment:
4+
types: [created]
5+
jobs:
6+
post-status-updates-to-slack:
7+
runs-on: ubuntu-latest
8+
if: contains(github.event.comment.body, '_created with') && contains(github.event.comment.body, 'typing_ `/status`')
9+
steps:
10+
- name: Trim HTML comments
11+
id: trimmed
12+
uses: ashley-taylor/regex-property-action@93a24f845cd20790924208225cc72da8b4c6d46d
13+
with:
14+
value: ${{github.event.comment.body}}
15+
regex: '<!--(.*?)-->'
16+
replacement: ''
17+
- name: Send Slack notification
18+
uses: archive/github-actions-slack@d368c5a4ad757515a9344918f84c490b05777d94
19+
id: notify
20+
with:
21+
slack-channel: 'C01EEKVR0Q7'
22+
slack-bot-user-oauth-access-token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }}
23+
slack-text: \n><${{ github.event.comment.html_url}}|*${{github.event.issue.title}}*>\nstatus update posted by ${{github.event.comment.user.login}}\n\n${{ steps.trimmed.outputs.value }}

‎.github/workflows/triage-stale-check.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ jobs:
2828
days-before-pr-stale: 14
2929
days-before-pr-close: -1 # Never close
3030
remove-stale-when-updated: false
31+
operations-per-run: 100
3132
only-labels: 'waiting for review'
3233
# The hope is that by setting the stale-pr-label to the same label
3334
# as the label that the stale check looks for, this will result in

‎content/actions/hosting-your-own-runners/about-self-hosted-runners.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ For more information about installing and using self-hosted runners, see "[Addin
4949

5050
You can use any machine as a self-hosted runner as long at it meets these requirements:
5151

52-
* You can install and run the self-hosted runner application on the machine. For more information, see "[Supported operating systems for self-hosted runners](#supported-operating-systems-for-self-hosted-runners)."
52+
* You can install and run the self-hosted runner application on the machine. For more information, see "[Supported architectures and operating systems for self-hosted runners](#supported-architectures-and-operating-systems-for-self-hosted-runners)."
5353
* The machine can communicate with {% data variables.product.prodname_actions %}. For more information, see "[Communication between self-hosted runners and {% data variables.product.prodname_dotcom %}](#communication-between-self-hosted-runners-and-github)."
5454
* The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
5555
* If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
@@ -120,6 +120,7 @@ You must ensure that the machine has the appropriate network access to communica
120120
github.com
121121
api.github.com
122122
*.actions.githubusercontent.com
123+
github-releases.githubusercontent.com
123124
codeload.github.com
124125
```
125126

‎content/actions/learn-github-actions/security-hardening-for-github-actions.md‎

Lines changed: 36 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ Some customers might attempt to partially mitigate these risks by implementing s
115115

116116
You can use the audit log to monitor administrative tasks in an organization. The audit log records the type of action, when it was run, and which user account performed the action.
117117

118-
For example, you can use the audit log to track the `action:org.update_actions_secret` event, which tracks changes to organization secrets:
118+
For example, you can use the audit log to track the `org.update_actions_secret` event, which tracks changes to organization secrets:
119119
![Audit log entries](/assets/images/help/repository/audit-log-entries.png)
120120

121121
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
@@ -124,26 +124,45 @@ The following tables describe the {% data variables.product.prodname_actions %}
124124
#### Events for secret management
125125
| Action | Description
126126
|------------------|-------------------
127-
| `action:org.create_actions_secret` | Triggered when a organization admin [creates a {% data variables.product.prodname_actions %} secret](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization).
128-
| `action:org.remove_actions_secret` | Triggered when a organization admin removes a {% data variables.product.prodname_actions %} secret.
129-
| `action:org.update_actions_secret` | Triggered when a organization admin updates a {% data variables.product.prodname_actions %} secret.
130-
| `action:repo.create_actions_secret ` | Triggered when a repository admin [creates a {% data variables.product.prodname_actions %} secret](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository).
131-
| `action:repo.remove_actions_secret` | Triggered when a repository admin removes a {% data variables.product.prodname_actions %} secret.
132-
| `action:repo.update_actions_secret` | Triggered when a repository admin updates a {% data variables.product.prodname_actions %} secret.
133-
127+
| `org.create_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is created for an organization. For more information, see "[Creating encrypted secrets for an organization](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)."
128+
| `org.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed.
129+
| `org.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated.
130+
| `repo.create_actions_secret ` | Triggered when a {% data variables.product.prodname_actions %} secret is created for a repository. For more information, see "[Creating encrypted secrets for a repository](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)."
131+
| `repo.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed.
132+
| `repo.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated.
133+
134+
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
134135
#### Events for self-hosted runners
135136
| Action | Description
136137
|------------------|-------------------
137-
| `action:org.register_self_hosted_runner` | Triggered when an organization owner [registers a new self-hosted runner](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization).
138-
| `action:org.remove_self_hosted_runner` | Triggered when an organization owner [removes a self-hosted runner](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization).
139-
| `action:repo.register_self_hosted_runner` | Triggered when a repository admin [registers a new self-hosted runner](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository).
140-
| `action:repo.remove_self_hosted_runner` | Triggered when a repository admin [removes a self-hosted runner](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository).
138+
| `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)."
139+
| `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)."
140+
| `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)."
141+
| `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).
142+
| `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)."
143+
| `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)."
144+
| `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)."
145+
| `repo.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)."
146+
{% endif %}
141147

148+
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
142149
#### Events for self-hosted runner groups
143150
| Action | Description
144151
|------------------|-------------------
145-
| `action:org.runner_group_created` | Triggered when an organization admin [creates a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization).
146-
| `action:org.runner_group_removed` | Triggered when an organization admin removes a self-hosted runner group.
147-
| `action:org.runner_group_renamed` | Triggered when an organization admin renames a self-hosted runner group.
148-
| `action:org.runner_group_runners_added` | Triggered when an organization admin [adds 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).
149-
| `action:org.runner_group_runners_removed` | Triggered when an organization admin removes a self-hosted runner from a group.
152+
| `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)."
153+
| `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)."
154+
| `enterprise.runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group.
155+
| `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)."
156+
| `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)."
157+
| `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)."
158+
| `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)."
159+
| `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)."
160+
| `org.runner_group_runner_removed` | Triggered when a self-hosted runner is removed from a group.
161+
{% endif %}
162+
163+
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
164+
#### Events for workflow activities
165+
166+
{% data reusables.actions.actions-audit-events-workflow %}
167+
168+
{% endif %}

‎content/actions/managing-workflow-runs/reviewing-deployments.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ versions:
1313

1414
Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled.
1515

16-
For more information about environments and required approvals, see "[Environments](/actions/reference/environments)."
16+
For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." For information about how to review deployments with the REST API, see "[Workflow Runs](/rest/reference/actions#workflow-runs)."
1717

1818
### Approving or rejecting a job
1919

0 commit comments

Comments
 (0)