Fix up Projects workflow articles (#36306)

This commit is contained in:
Steve Guntrip 2023-04-18 09:43:05 +01:00 коммит произвёл GitHub
Родитель 6de41c803a
Коммит dda58a5310
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
11 изменённых файлов: 83204 добавлений и 39 удалений

83142
.linkinator/full.log Normal file

Разница между файлами не показана из-за своего большого размера Загрузить разницу

Двоичные данные
assets/images/help/projects-v2/open-menu.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.9 KiB

После

Ширина:  |  Высота:  |  Размер: 13 KiB

Двоичные данные
assets/images/help/projects-v2/workflow-add-menu.png Normal file

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 26 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.1 KiB

После

Ширина:  |  Высота:  |  Размер: 9.9 KiB

Просмотреть файл

@ -1,6 +1,6 @@
---
title: Adding items automatically
intro: You can configure your project's built-in workflows to automatically add items from a repository that match a filter.
intro: You can configure your project's built-in workflows to automatically add items from {% ifversion projects-v2-duplicate-auto-add %}repositories{% else%}a repository{% endif %} that match a filter.
versions:
feature: projects-v2-auto-add
type: tutorial
@ -10,7 +10,7 @@ topics:
## About automatically adding items
You can configure your project's built-in workflows to automatically add new items as they are created or updated in a repository. You can define a filter to only add items that meet your criteria.
You can configure your project's built-in workflows to automatically add new items as they are created or updated in a repository. You can define a filter to only add items that meet your criteria. {% ifversion projects-v2-duplicate-auto-add %} You can also create multiple auto-add workflows, each workflow can have a unique filter and target a different repository. {% endif %}
When you enable the auto-add workflow, existing items matching your criteria will not be added. The workflow will add items when created or updated if the item matches your filter. For more information on manually adding items, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#bulk-adding-issues-and-pull-requests)."
@ -26,6 +26,8 @@ The auto-add workflow supports a subset of filters. You can use the following fi
All filters, other than `no`, support negation. For example, you could use `-label:bug` to add issues that do not have the "bug" label.
{% ifversion projects-v2-duplicate-auto-add %}
The auto-add workflow is limited per plan.
| Product | Maximum auto-add workflows |
@ -36,30 +38,39 @@ The auto-add workflow is limited per plan.
| {% data variables.product.prodname_ghe_cloud %} | 20 |
| {% data variables.product.prodname_ghe_server %} | 20 |
{% endif %}
## Configuring the auto-add workflow in your project
{% data reusables.projects.access-workflows %}
1. In the "Default workflows" list, click **Auto-add to project**.
![Screenshot showing auto-add workflow](/assets/images/help/projects-v2/workflow-autoadd.png)
1. In the "Default workflows" list, click **Auto-add to project**{% ifversion projects-v2-duplicate-auto-add %} or one of the auto-add workflows you have previously duplicated{% endif %}.
1. To start editing the workflow, in the top right, click **Edit**.
![Screenshot showing edit button](/assets/images/help/projects-v2/workflow-start-editing.png)
1. Under "Filters", select the repository you want to add items from.
![Screenshot showing repository select](/assets/images/help/projects-v2/workflow-autoadd-repo.png)
![Screenshot showing the workflow menu bar. The "Edit" button is highlighted with an orange rectangle.](/assets/images/help/projects-v2/workflow-start-editing.png)
1. Under "Filters", select the repository you want to add items from.
1. Next to the repository selection, type the filter criteria you want items to match before they are automatically added to your project.
![Screenshot showing repository select](/assets/images/help/projects-v2/workflow-autoadd-filter.png)
1. To enable the new workflow, click **Save and turn on workflow**.
![Screenshot showing autoadd workflows](/assets/images/help/projects-v2/workflow-save-and-turn-on.png)
{% ifversion projects-v2-duplicate-auto-add %}
## Duplicating the auto-add workflow
You can create additional duplicates of the auto-add workflow. Each workflow can target a different repository, allowing you to add items from up to four repositories. You can target the same repository with multiple workflows if the filter is unique for each workflow.
Once you have duplicated a workflow, you can click **Edit** to start making changes to it. For more information, see "[Configuring the auto-add workflow in your project](#configuring-the-auto-add-workflow-in-your-project)."
{% data reusables.projects.access-workflows %}
1. In the list of workflows, next to "Auto-add to project" click {% octicon "kebab-horizontal" %}.
![Screenshot showing the list of workflows. The ellipsis button next to the auto-add workflow is highlighted with an orange rectangle.](/assets/images/help/projects-v2/workflow-add-menu.png)
1. In the menu, click **{% octicon "duplicate" %} Duplicate workflow**.
1. To save your new workflow, when prompted, type the name you want to use for the new workflow.
{% endif %}
## Further reading

Просмотреть файл

@ -22,21 +22,15 @@ Projects also have a limit on the number of archived items they can contain. You
## Configuring automatic archiving in your project
{% data reusables.projects.access-workflows %}
1. In the "Default workflows" list, click **Auto-archive items**.
![Screenshot showing auto archive workflows](/assets/images/help/projects-v2/archive-workflows.png)
1. Next to **When**, check the item type(s) that you want to automatically archive.
![Screenshot showing the "when" configuration for a workflow](/assets/images/help/projects-v2/workflow-when-archive.png)
1. In the "Default workflows" list, click **Auto-archive items**.{% ifversion projects-v2-workflows-ui-refresh %}
1. In the top right, click **Edit**.
1. Next to {% octicon "filter" aria-label="The filter icon" %}, type the filter criteria you want to use to automatically archive items. You can only use the `is`, `reason`, and `last-updated` filters. For more information about filter syntax, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)."
![Screenshot showing filter text area](/assets/images/help/projects-v2/auto-archive-filter.png)
1. If the workflow is disabled, click the toggle next to **Off** to enable the workflow.
![Screenshot showing the "On/Off" control for a workflow](/assets/images/help/projects-v2/workflow-enable.png)
![Screenshot showing a project's menu bar. The "Edit" button is highlighted with an orange rectangle.](/assets/images/help/projects-v2/workflow-start-editing.png)
{% endif %}
1. Next to **When**, check the item type(s) that you want to automatically archive.
1. Next to {% octicon "filter" aria-label="The filter icon" %}, type the filter criteria you want to use to automatically archive items. You can only use the `is`, `reason`, and `last-updated` filters. For more information about filter syntax, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)."{% ifversion projects-v2-workflows-ui-refresh %}
1. To save your changes and enable the workflow, click **Save and turn on workflow**.{% else %}
1. If the workflow is disabled, click the toggle next to **Off** to enable the workflow.{% endif %}
## Further reading

Просмотреть файл

@ -2,3 +2,4 @@
versions:
fpt: '*'
ghec: '*'
ghes: '>=3.8'

Просмотреть файл

@ -0,0 +1,4 @@
# Issue 9608
versions:
fpt: '*'
ghec: '*'

Просмотреть файл

@ -0,0 +1,5 @@
# Issue 9608
versions:
fpt: '*'
ghec: '*'
ghes: '>=3.10'

Просмотреть файл

@ -1,5 +1,6 @@
1. Navigate to your project.
1. In the top-right, click {% octicon "kebab-horizontal" aria-label="The menu icon" %} to open the menu.
![Screenshot showing the menu icon](/assets/images/help/projects-v2/open-menu.png)
![Screenshot showing the top right of a project. The ellipsis button is highlighted with an orange rectangle.](/assets/images/help/projects-v2/open-menu.png)
1. In the menu, click {% octicon "workflow" aria-label="The workflow icon" %} **Workflows**.
![Screenshot showing the 'Workflows' menu item](/assets/images/help/projects-v2/workflows-menu-item.png)

Просмотреть файл

@ -1,17 +1,24 @@
{% ifversion projects-v2-workflows-ui-refresh %}
{% data reusables.projects.access-workflows %}
1. Under **Default workflows**, click on the workflow that you want to edit.
1. Under "Default workflows", click on the workflow that you want to edit.
1. In the top right, click **Edit**.
![Screenshot showing default workflows](/assets/images/help/projects-v2/default-workflows.png)
2. If the workflow can apply to both issues and pull requests, next to **When**, check the item type(s) that you want to act on.
![Screenshot showing a project's menu bar. The "Edit" button is highlighted with an orange rectangle.](/assets/images/help/projects-v2/workflow-start-editing.png)
![Screenshot showing the "when" configuration for a workflow](/assets/images/help/projects-v2/workflow-when.png)
1. Select whether the workflow should apply to issues, pull requests, or both.
1. Under "Set value", choose the value that you want to set the status to.
1. To save your changes and enable the workflow, click **Save and turn on workflow**.
3. Next to **Set**, choose the value that you want to set the status to.
![Screenshot showing the "set" configuration for a workflow](/assets/images/help/projects-v2/workflow-set.png)
{% else %}
4. If the workflow is disabled, click the toggle next to **Off** to enable the workflow.
{% data reusables.projects.access-workflows %}
1. Under "Default workflows", click on the workflow that you want to edit.
1. Select whether the workflow should apply to issues, pull requests, or both.
1. Next to "Set", choose the value that you want to set the status to.
1. If the workflow is disabled, click the toggle next to "Off" to enable the workflow.
![Screenshot showing the "On/Off" control for a workflow](/assets/images/help/projects-v2/workflow-enable.png)
{% endif %}