Skip to content

Commit 07f59b3

Browse files
authored
Merge pull request #14048 from github/repo-sync
repo sync
2 parents 5d57041 + 7f5202e commit 07f59b3

File tree

42 files changed

+1859
-717
lines changed

Some content is hidden

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

42 files changed

+1859
-717
lines changed

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ topics:
1515
- Profiles
1616
shortTitle: Organization's profile
1717
---
18-
You can optionally choose to add a description, location, website, and email address for your organization, and pin important repositories.{% ifversion not ghes and not ghae %} You can customize your organization's profile by adding a README.md file. For more information, see "[Customizing your organization's profile](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile)."{% endif %}
18+
You can optionally choose to add a description, location, website, and email address for your organization, and pin important repositories.{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4749 %} You can customize your organization's profile by adding a README.md file. For more information, see "[Customizing your organization's profile](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile)."{% endif %}
1919

2020
{% ifversion fpt or ghec %}To confirm your organization's identity and display a "Verified" badge on your organization profile page, you must verify your organization's domains with {% data variables.product.product_name %}. For more information, see "[Verifying or approving a domain for your organization](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)."{% endif %}
2121

content/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ You can configure a subject that filters for a specific [environment](/actions/d
161161

162162
#### Filtering for `pull_request` events
163163

164-
You can configure a subject that filters for the [`pull_request`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags) event. In this example, the workflow run must have been triggered by a `pull_request` event in a repository named `octo-repo` that is owned by the `octo-org` organization:
164+
You can configure a subject that filters for the [`pull_request`](/actions/learn-github-actions/events-that-trigger-workflows#pull_request) event. In this example, the workflow run must have been triggered by a `pull_request` event in a repository named `octo-repo` that is owned by the `octo-org` organization:
165165

166166

167167
| | |

content/actions/learn-github-actions/events-that-trigger-workflows.md

Lines changed: 1020 additions & 300 deletions
Large diffs are not rendered by default.

content/actions/learn-github-actions/understanding-github-actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ To help you understand how YAML syntax is used to create a workflow file, this s
114114
```
115115
</td>
116116
<td>
117-
Specifies the trigger for this workflow. This example uses the <code>push</code> event, so a workflow run is triggered every time someone pushes a change to the repository or merges a pull request. This is triggered by a push to every branch; for examples of syntax that runs only on pushes to specific branches, paths, or tags, see <a href="https://docs.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths">"Workflow syntax for {% data variables.product.prodname_actions %}."</a>
117+
Specifies the trigger for this workflow. This example uses the <code>push</code> event, so a workflow run is triggered every time someone pushes a change to the repository or merges a pull request. This is triggered by a push to every branch; for examples of syntax that runs only on pushes to specific branches, paths, or tags, see <a href="https://docs.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore">"Workflow syntax for {% data variables.product.prodname_actions %}."</a>
118118
</td>
119119
</tr>
120120
<tr>

content/actions/learn-github-actions/workflow-syntax-for-github-actions.md

Lines changed: 177 additions & 50 deletions
Large diffs are not rendered by default.

content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ Jenkins uses directives to manage _Declarative Pipelines_. These directives defi
6464
| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs.<job_id>.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) <br> [`jobs.<job_id>.steps[*].env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) |
6565
| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs.<job_id>.strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy) <br> [`jobs.<job_id>.strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast) <br> [`jobs.<job_id>.timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) |
6666
| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs) <br> [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) |
67-
| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on) <br> [`on.<event_name>.types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes) <br> [<code>on.<push\|pull_request>.<branches\|tags></code>](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags) <br> [<code>on.<push\|pull_request>.paths</code>](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) |
67+
| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on) <br> [`on.<event_name>.types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes) <br> [<code>on.<push\>.<branches\|tags></code>](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushbranchestagsbranches-ignoretags-ignore) <br> [<code>on.<pull_request\>.<branches\></code>](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpull_requestpull_request_targetbranchesbranches-ignore) <br> [<code>on.<push\|pull_request>.paths</code>](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore) |
6868
| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs.<job_id>.needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) |
6969
| [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) |
7070
| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.<job_id>`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id) <br> [`jobs.<job_id>.name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) |

content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ jobs:
102102
103103
### Targeting specific branches
104104
105-
Travis CI and {% data variables.product.prodname_actions %} both allow you to target your CI to a specific branch. For more information, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)."
105+
Travis CI and {% data variables.product.prodname_actions %} both allow you to target your CI to a specific branch. For more information, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#onpushbranchestagsbranches-ignoretags-ignore)."
106106
107107
Below is an example of the syntax for each system:
108108

content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ Additionally, when an `on:push` scan returns results that can be mapped to an op
7878

7979
The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on pull requests targeted against the default branch. {% ifversion ghes %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %}
8080

81-
For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)."
81+
For more information about the `pull_request` event, see "[Events that trigger workflows](/actions/learn-github-actions/events-that-trigger-workflows#pull_request)."
8282

8383
If you scan pull requests, then the results appear as alerts in a pull request check. For more information, see "[Triaging code scanning alerts in pull requests](/code-security/secure-coding/triaging-code-scanning-alerts-in-pull-requests)."
8484

@@ -126,7 +126,7 @@ on:
126126

127127
{% endnote %}
128128

129-
For more information about using `on:pull_request:paths-ignore` and `on:pull_request:paths` to determine when a workflow will run for a pull request, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)."
129+
For more information about using `on:pull_request:paths-ignore` and `on:pull_request:paths` to determine when a workflow will run for a pull request, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore)."
130130

131131
### Scanning on a schedule
132132

@@ -466,15 +466,15 @@ paths-ignore:
466466

467467
**Note**:
468468

469-
* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on.<push|pull_request>.paths` in a workflow. When they are used to modify `on.<push|pull_request>` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)."
469+
* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on.<push|pull_request>.paths` in a workflow. When they are used to modify `on.<push|pull_request>` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore)."
470470
* The filter pattern characters `?`, `+`, `[`, `]`, and `!` are not supported and will be matched literally.
471471
* `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character.
472472

473473
{% endnote %}
474474

475475
For compiled languages, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/code-security/secure-coding/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
476476

477-
You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.<push|pull_request>`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow.
477+
You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.<push|pull_request>`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore) in your workflow.
478478

479479
### Example configuration files
480480

content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ The default {% data variables.product.prodname_codeql_workflow %} uses a build m
180180

181181
Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time.
182182

183-
For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)."
183+
For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore)."
184184

185185
For languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without compiling the source code, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/code-security/secure-coding/configuring-code-scanning#specifying-directories-to-scan)."
186186

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

Lines changed: 32 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ Webhook events are triggered based on the specificity of the domain you register
240240
241241
{% note %}
242242
243-
**Note:** You will not receive a webhook for this event when you push more than three tags at once.
243+
**Note:** You will not receive a webhook for this event when you create more than three tags at once.
244244
245245
{% endnote %}
246246
@@ -382,7 +382,7 @@ Activity related to a discussion. For more information, see the "[Using the Grap
382382
383383
Key | Type | Description
384384
----|------|-------------
385-
`action` |`string` | The action performed. Can be `created`, `edited`, `deleted`, `pinned`, `unpinned`, `locked`, `unlocked`, `transferred`, `category_changed`, `answered`, or `unanswered`.
385+
`action` |`string` | The action performed. Can be `created`, `edited`, `deleted`, `pinned`, `unpinned`, `locked`, `unlocked`, `transferred`, `category_changed`, `answered`, `unanswered`, `labeled`, or `unlabeled`.
386386
{% data reusables.webhooks.discussion_desc %}
387387
{% data reusables.webhooks.repo_desc_graphql %}
388388
{% data reusables.webhooks.org_desc_graphql %}
@@ -856,53 +856,71 @@ Key | Type | Description
856856
857857
{{ webhookPayloadsForCurrentVersion.ping }}
858858
859-
## project_card
859+
## project
860860
861-
{% data reusables.webhooks.project_card_short_desc %}
861+
{% data reusables.webhooks.project_short_desc %}
862862
863863
### Availability
864864
865865
- Repository webhooks
866866
- Organization webhooks
867867
- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission
868868
869+
{% ifversion fpt or ghec %}
870+
{% note %}
871+
872+
**Note**: This event does not occur for Projects (beta).
873+
874+
{% endnote %}
875+
{% endif %}
876+
869877
### Webhook payload object
870878
871-
{% data reusables.webhooks.project_card_properties %}
879+
{% data reusables.webhooks.project_properties %}
872880
{% data reusables.webhooks.repo_desc %}
873881
{% data reusables.webhooks.org_desc %}
874882
{% data reusables.webhooks.app_desc %}
875883
{% data reusables.webhooks.sender_desc %}
876884
877885
### Webhook payload example
878886
879-
{{ webhookPayloadsForCurrentVersion.project_card.created }}
887+
{{ webhookPayloadsForCurrentVersion.project.created }}
880888
881-
## project_column
889+
{% ifversion fpt or ghes or ghec %}
882890
883-
{% data reusables.webhooks.project_column_short_desc %}
891+
## project_card
892+
893+
{% data reusables.webhooks.project_card_short_desc %}
884894
885895
### Availability
886896
887897
- Repository webhooks
888898
- Organization webhooks
889899
- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission
890900
901+
{% ifversion fpt or ghec %}
902+
{% note %}
903+
904+
**Note**: This event does not occur for Projects (beta).
905+
906+
{% endnote %}
907+
{% endif %}
908+
891909
### Webhook payload object
892910
893-
{% data reusables.webhooks.project_column_properties %}
911+
{% data reusables.webhooks.project_card_properties %}
894912
{% data reusables.webhooks.repo_desc %}
895913
{% data reusables.webhooks.org_desc %}
896914
{% data reusables.webhooks.app_desc %}
897915
{% data reusables.webhooks.sender_desc %}
898916
899917
### Webhook payload example
900918
901-
{{ webhookPayloadsForCurrentVersion.project_column.created }}
919+
{{ webhookPayloadsForCurrentVersion.project_card.created }}
902920
903-
## project
921+
## project_column
904922
905-
{% data reusables.webhooks.project_short_desc %}
923+
{% data reusables.webhooks.project_column_short_desc %}
906924
907925
### Availability
908926
@@ -912,17 +930,16 @@ Key | Type | Description
912930
913931
### Webhook payload object
914932
915-
{% data reusables.webhooks.project_properties %}
933+
{% data reusables.webhooks.project_column_properties %}
916934
{% data reusables.webhooks.repo_desc %}
917935
{% data reusables.webhooks.org_desc %}
918936
{% data reusables.webhooks.app_desc %}
919937
{% data reusables.webhooks.sender_desc %}
920938
921939
### Webhook payload example
922940
923-
{{ webhookPayloadsForCurrentVersion.project.created }}
941+
{{ webhookPayloadsForCurrentVersion.project_column.created }}
924942
925-
{% ifversion fpt or ghes or ghec %}
926943
## public
927944
928945
{% data reusables.webhooks.public_short_desc %}

content/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ intro: You can share information about your organization by customizing your org
44
versions:
55
fpt: '*'
66
ghec: '*'
7+
ghes: '>3.3'
8+
ghae: 'issue-4749'
79
topics:
810
- Organizations
911
shortTitle: Customize organization profile

0 commit comments

Comments
 (0)