Skip to content

Commit c6f0298

Browse files
authored
Branch was updated using the 'autoupdate branch' Actions workflow.
2 parents 690cace + a34dcc4 commit c6f0298

160 files changed

Lines changed: 15014 additions & 1048 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/allowed-actions.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,6 @@ module.exports = [
3939
"repo-sync/pull-request@33777245b1aace1a58c87a29c90321aa7a74bd7d",
4040
"someimportantcompany/github-actions-slack-message@0b470c14b39da4260ed9e3f9a4f1298a74ccdefd",
4141
"tjenkinson/gh-action-auto-merge-dependency-updates@4d7756c04d9d999c5968697a621b81c47f533d61",
42-
"EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575",
42+
"EndBug/add-and-commit@b3c7c1e078a023d75fb0bd326e02962575ce0519",
4343
"dorny/paths-filter@eb75a1edc117d3756a18ef89958ee59f9500ba58",
4444
];

.github/workflows/openapi-decorate.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,10 @@ jobs:
2525
run: script/rest/update-files.js --decorate-only
2626

2727
- name: Check in the decorated files
28-
uses: EndBug/add-and-commit@9358097a71ad9fb9e2f9624c6098c89193d83575
28+
uses: EndBug/add-and-commit@b3c7c1e078a023d75fb0bd326e02962575ce0519
2929
with:
3030
# The arguments for the `git add` command
3131
add: 'lib/rest/static/decorated'
3232

3333
# The message for the commit
3434
message: 'Add decorated OpenAPI schema files'
35-
36-
env:
37-
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Leave this line unchanged
36.1 KB
Loading
107 KB
Loading
36.7 KB
Loading
45.9 KB
Loading
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Adding labels to issues
3+
intro: You can use {% data variables.product.prodname_actions %} to automatically label issues.
4+
product: '{% data reusables.gated-features.actions %}'
5+
versions:
6+
free-pro-team: '*'
7+
enterprise-server: '>=2.22'
8+
github-ae: '*'
9+
type: 'tutorial'
10+
topics:
11+
- 'Workflows'
12+
- 'Project management'
13+
---
14+
15+
{% data reusables.actions.enterprise-beta %}
16+
{% data reusables.actions.enterprise-github-hosted-runners %}
17+
{% data reusables.actions.ae-beta %}
18+
{% data reusables.actions.ae-self-hosted-runners-notice %}
19+
20+
### Introduction
21+
22+
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.
23+
24+
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.
25+
26+
### Creating the workflow
27+
28+
1. {% data reusables.actions.choose-repo %}
29+
2. {% data reusables.actions.make-workflow-file %}
30+
3. Copy the following YAML contents into your workflow file.
31+
32+
{% raw %}
33+
```yaml{:copy}
34+
name: Label issues
35+
on:
36+
issues:
37+
types:
38+
- reopened
39+
- opened
40+
jobs:
41+
label_issues:
42+
runs-on: ubuntu-latest
43+
steps:
44+
- name: Label issues
45+
uses: andymckay/labeler@1.0.2
46+
with:
47+
add-labels: "triage"
48+
```
49+
{% endraw %}
50+
4. Customize the parameters in your workflow file:
51+
- 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)."
52+
5. {% data reusables.actions.commit-workflow %}
53+
54+
### Testing the workflow
55+
56+
Every time an issue in your repository is opened or reopened, this workflow will add the labels that you specified to the issue.
57+
58+
Test out your workflow by creating an issue in your repository.
59+
60+
1. Create an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
61+
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)."
62+
3. When the workflow completes, the issue that you created should have the specified labels added.
63+
64+
### Next steps
65+
66+
- 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).
67+
- 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.
68+
- [Search GitHub](https://github.com/search?q=%22uses:+andymckay/labeler%22&type=code) for examples of workflows using this action.
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
title: Closing inactive issues
3+
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.
4+
product: '{% data reusables.gated-features.actions %}'
5+
versions:
6+
free-pro-team: '*'
7+
enterprise-server: '>=2.22'
8+
github-ae: '*'
9+
type: 'tutorial'
10+
topics:
11+
- 'Workflows'
12+
- 'Project management'
13+
---
14+
15+
{% data reusables.actions.enterprise-beta %}
16+
{% data reusables.actions.enterprise-github-hosted-runners %}
17+
{% data reusables.actions.ae-beta %}
18+
{% data reusables.actions.ae-self-hosted-runners-notice %}
19+
20+
### Introduction
21+
22+
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.
23+
24+
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.
25+
26+
### Creating the workflow
27+
28+
1. {% data reusables.actions.choose-repo %}
29+
2. {% data reusables.actions.make-workflow-file %}
30+
3. Copy the following YAML contents into your workflow file.
31+
32+
{% raw %}
33+
```yaml{:copy}
34+
name: Close inactive issues
35+
on:
36+
schedule:
37+
- cron: "30 1 * * *"
38+
39+
jobs:
40+
close-issues:
41+
runs-on: ubuntu-latest
42+
steps:
43+
- uses: actions/stale@v3
44+
with:
45+
days-before-issue-stale: 30
46+
days-before-issue-close: 14
47+
stale-issue-label: "stale"
48+
stale-issue-message: "This issue is stale because it has been open for 30 days with no activity."
49+
close-issue-message: "This issue was closed because it has been inactive for 14 days since being marked as stale."
50+
days-before-pr-stale: -1
51+
days-before-pr-close: -1
52+
repo-token: ${{ secrets.GITHUB_TOKEN }}
53+
```
54+
{% endraw %}
55+
4. Customize the parameters in your workflow file:
56+
- 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)."
57+
- 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`.
58+
- 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`.
59+
- 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`.
60+
- 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.
61+
- 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.
62+
5. {% data reusables.actions.commit-workflow %}
63+
64+
### Expected results
65+
66+
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.
67+
68+
{% data reusables.actions.schedule-delay %}
69+
70+
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)."
71+
72+
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).
73+
74+
### Next steps
75+
76+
- 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).
77+
- [Search GitHub](https://github.com/search?q=%22uses%3A+actions%2Fstale%22&type=code) for examples of workflows using this action.
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Commenting on an issue when a label is added
3+
intro: You can use {% data variables.product.prodname_actions %} to automatically comment on issues when a specific label is applied.
4+
product: '{% data reusables.gated-features.actions %}'
5+
versions:
6+
free-pro-team: '*'
7+
enterprise-server: '>=2.22'
8+
github-ae: '*'
9+
type: 'tutorial'
10+
topics:
11+
- 'Workflows'
12+
- 'Project management'
13+
---
14+
15+
{% data reusables.actions.enterprise-beta %}
16+
{% data reusables.actions.enterprise-github-hosted-runners %}
17+
{% data reusables.actions.ae-beta %}
18+
{% data reusables.actions.ae-self-hosted-runners-notice %}
19+
20+
### Introduction
21+
22+
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.
23+
24+
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.
25+
26+
### Creating the workflow
27+
28+
1. {% data reusables.actions.choose-repo %}
29+
2. {% data reusables.actions.make-workflow-file %}
30+
3. Copy the following YAML contents into your workflow file.
31+
32+
{% raw %}
33+
```yaml{:copy}
34+
name: Add comment
35+
on:
36+
issues:
37+
types:
38+
- labeled
39+
jobs:
40+
add-comment:
41+
if: github.event.label.name == 'help-wanted'
42+
runs-on: ubuntu-latest
43+
steps:
44+
- name: Add comment
45+
uses: peter-evans/create-or-update-comment@v1
46+
with:
47+
issue-number: ${{ github.event.issue.number }}
48+
body: |
49+
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:
50+
```
51+
{% endraw %}
52+
4. Customize the parameters in your workflow file:
53+
- 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.
54+
- 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)."
55+
5. {% data reusables.actions.commit-workflow %}
56+
57+
### Testing the workflow
58+
59+
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.
60+
61+
Test your workflow by applying your specified label to an issue.
62+
63+
1. Open an issue in your repository. For more information, see "[Creating an issue](/github/managing-your-work-on-github/creating-an-issue)."
64+
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)."
65+
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)."
66+
4. When the workflow completes, the issue that you labeled should have a comment added.
67+
68+
### Next steps
69+
70+
- 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).

content/actions/guides/index.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,13 @@ includeGuides:
6262
- /actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions
6363
- /actions/learn-github-actions/migrating-from-jenkins-to-github-actions
6464
- /actions/learn-github-actions/migrating-from-travis-ci-to-github-actions
65+
- /actions/guides/using-github-actions-for-project-management
66+
- /actions/guides/closing-inactive-issues
67+
- /actions/guides/scheduling-issue-creation
68+
- /actions/guides/adding-labels-to-issues
69+
- /actions/guides/commenting-on-an-issue-when-a-label-is-added
70+
- /actions/guides/moving-assigned-issues-on-project-boards
71+
- /actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column
6572

6673
---
6774
<!-- {% link_in_list /about-continuous-integration %} -->
@@ -87,3 +94,11 @@ includeGuides:
8794
<!-- {% link_in_list /deploying-to-amazon-elastic-container-service %} -->
8895
<!-- {% link_in_list /deploying-to-azure-app-service %} -->
8996
<!-- {% link_in_list /deploying-to-google-kubernetes-engine %} -->
97+
<!-- {% link_in_list /deploying-to-google-kubernetes-engine %} -->
98+
<!-- {% link_in_list /using-github-actions-for-project-management %} -->
99+
<!-- {% link_in_list /closing-inactive-issues %} -->
100+
<!-- {% link_in_list /scheduling-issue-creation %} -->
101+
<!-- {% link_in_list /adding-labels-to-issues %} -->
102+
<!-- {% link_in_list /commenting-on-an-issue-when-a-label-is-added %} -->
103+
<!-- {% link_in_list /moving-assigned-issues-on-project-boards %} -->
104+
<!-- {% link_in_list /removing-a-label-when-a-card-is-added-to-a-project-board-column %} -->

0 commit comments

Comments
 (0)