зеркало из https://github.com/github/docs.git
Reorganize content on labeling (#16402)
This commit is contained in:
Matt Pollard
GitHub
Родитель
03c385e987
Коммит
9340ce03f6
|
|
@ -1,42 +0,0 @@
|
|||
---
|
||||
title: About labels
|
||||
intro: 'Labels on {% data variables.product.product_name %} help you organize and prioritize your work. You can apply labels to issues and pull requests to signify priority, category, or any other information you find useful.'
|
||||
redirect_from:
|
||||
- /articles/about-labels
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
Labels are tied to the repository they are created in. Once a label exists, you can use it on any issue or pull request within that repository. For more information, see "[Creating a label](/articles/creating-a-label/)."
|
||||
|
||||
Anyone with read access to a repository can view and search the repository’s labels. To create, edit, apply, or delete a label, you must have write access to the repository.
|
||||
|
||||
### Using default labels
|
||||
|
||||
{% data variables.product.product_name %} provides default labels in every new repository. You can use these default labels to help create a standard workflow in a repository:
|
||||
|
||||
Label | Description
|
||||
--- | ---
|
||||
`bug` | Indicates an unexpected problem or unintended behavior
|
||||
`documentation` | Indicates a need for improvements or additions to documentation
|
||||
`duplicate` | Indicates similar issues or pull requests
|
||||
`enhancement` | Indicates new feature requests
|
||||
`good first issue` | Indicates a good issue for first-time contributors
|
||||
`help wanted` | Indicates that a maintainer wants help on an issue or pull request
|
||||
`invalid` | Indicates that an issue or pull request is no longer relevant
|
||||
`question` | Indicates that an issue or pull request needs more information
|
||||
`wontfix` | Indicates that work won't continue on an issue or pull request
|
||||
|
||||
Default labels are included in every new repository when the repository is created, but you can edit or delete the labels later. For more information, see "[Deleting a label](/articles/deleting-a-label/)."
|
||||
|
||||
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}
|
||||
Organization owners can customize the default labels for repositories in their organization. For more information, see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)."
|
||||
{% endif %}
|
||||
|
||||
{% if currentVersion == "free-pro-team@latest" %}
|
||||
### Further reading
|
||||
|
||||
- "[Encouraging helpful contributions to your project with labels](/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels)"
|
||||
{% endif %}
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
---
|
||||
title: Applying labels to issues and pull requests
|
||||
intro: 'In repositories where you have write access, you can assign labels to issues and pull requests to help organize your projects.'
|
||||
redirect_from:
|
||||
- /articles/customizing-issue-labels/
|
||||
- /articles/applying-labels-to-issues-and-pull-requests
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** You can apply up to a maximum of 100 labels to issues and pull requests.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.repositories.select-items-in-issue-or-pr-list %}
|
||||
4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items. You can also apply a label in the Labels drop-down menu within an issue or pull request.
|
||||
|
||||
|
||||
|
||||
### Further reading
|
||||
|
||||
- "[About labels](/articles/about-labels)"
|
||||
- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"
|
||||
|
|
@ -1,35 +0,0 @@
|
|||
---
|
||||
title: Creating a label
|
||||
intro: 'In repositories where you have write access, you can create labels to organize issues and pull requests.'
|
||||
redirect_from:
|
||||
- /articles/creating-and-editing-labels-for-issues-and-pull-requests/
|
||||
- /articles/creating-a-label
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** You can also create a label in the Labels drop-down menu within an issue or pull request.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
4. To the right of the search field, click **New label**.
|
||||
{% data reusables.project-management.name-label %}
|
||||
{% data reusables.project-management.label-description %}
|
||||
{% data reusables.project-management.label-color-randomizer %}
|
||||
{% data reusables.project-management.create-label %}
|
||||
|
||||
### Further reading
|
||||
|
||||
- "[About labels](/articles/about-labels)"
|
||||
- "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests)"
|
||||
- "[Editing a label](/articles/editing-a-label)"
|
||||
- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}
|
||||
- "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)"
|
||||
{% endif %}
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
---
|
||||
title: Deleting a label
|
||||
intro: 'In repositories where you have write access, you can delete a label if you no longer need it to classify issues or pull requests.'
|
||||
redirect_from:
|
||||
- /articles/deleting-a-label
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
Deleting a label will remove the label from any issues or pull requests where it's been applied.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
{% data reusables.project-management.delete-label %}
|
||||
|
||||
### Further reading
|
||||
|
||||
- "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests)"
|
||||
- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}
|
||||
- "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)"
|
||||
{% endif %}
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
---
|
||||
title: Editing a label
|
||||
intro: 'In repositories where you have write access, you can edit the name, color, and description of an existing label.'
|
||||
redirect_from:
|
||||
- /articles/editing-a-label
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
{% data reusables.project-management.edit-label %}
|
||||
{% data reusables.project-management.name-label %}
|
||||
{% data reusables.project-management.label-description %}
|
||||
{% data reusables.project-management.label-color-randomizer %}
|
||||
{% data reusables.project-management.save-label %}
|
||||
|
||||
### Further reading
|
||||
|
||||
- "[About labels](/articles/about-labels)"
|
||||
- "[Creating a label](/articles/creating-a-label)"
|
||||
- "[Deleting a label](/articles/deleting-a-label)"
|
||||
- "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests)"
|
||||
- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}
|
||||
- "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)"
|
||||
{% endif %}
|
||||
|
|
@ -14,7 +14,7 @@ versions:
|
|||
|
||||
### Table of Contents
|
||||
|
||||
{% topic_link_in_list /managing-your-work-with-issues %}
|
||||
{% topic_link_in_list /managing-your-work-with-issues-and-pull-requests %}
|
||||
{% link_in_list /about-issues %}
|
||||
{% link_in_list /creating-an-issue %}
|
||||
<!-- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" -->
|
||||
|
|
@ -27,6 +27,7 @@ versions:
|
|||
{% link_in_list /pinning-an-issue-to-your-repository %}
|
||||
<!-- endif -->
|
||||
{% link_in_list /creating-a-permanent-link-to-a-code-snippet %}
|
||||
{% link_in_list /managing-labels %}
|
||||
{% link_in_list /about-task-lists %}
|
||||
{% link_in_list /about-automation-for-issues-and-pull-requests-with-query-parameters %}
|
||||
{% link_in_list /file-attachments-on-issues-and-pull-requests %}
|
||||
|
|
@ -35,12 +36,6 @@ versions:
|
|||
{% link_in_list /disabling-issues %}
|
||||
{% link_in_list /linking-a-pull-request-to-an-issue %}
|
||||
{% link_in_list /about-duplicate-issues-and-pull-requests %}
|
||||
{% topic_link_in_list /labeling-issues-and-pull-requests %}
|
||||
{% link_in_list /about-labels %}
|
||||
{% link_in_list /creating-a-label %}
|
||||
{% link_in_list /applying-labels-to-issues-and-pull-requests %}
|
||||
{% link_in_list /editing-a-label %}
|
||||
{% link_in_list /deleting-a-label %}
|
||||
{% topic_link_in_list /managing-project-boards %}
|
||||
{% link_in_list /about-project-boards %}
|
||||
{% link_in_list /creating-a-project-board %}
|
||||
|
|
|
|||
|
|
@ -1,12 +0,0 @@
|
|||
---
|
||||
title: Labeling issues and pull requests
|
||||
intro: 'You can manage your work on {% data variables.product.product_name %} by creating labels to categorize issues and pull requests.'
|
||||
mapTopic: true
|
||||
redirect_from:
|
||||
- /articles/labeling-issues-and-pull-requests
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
|
|
@ -0,0 +1,98 @@
|
|||
---
|
||||
title: Managing labels
|
||||
intro: 'You can classify issues and pull requests by creating, editing, applying, and deleting labels.'
|
||||
redirect_from:
|
||||
- /articles/managing-Labels
|
||||
- /articles/labeling-issues-and-pull-requests
|
||||
- /github/managing-your-work-on-github/labeling-issues-and-pull-requests
|
||||
- /articles/about-labels
|
||||
- /github/managing-your-work-on-github/about-labels
|
||||
- /articles/creating-and-editing-labels-for-issues-and-pull-requests
|
||||
- /articles/creating-a-label
|
||||
- /github/managing-your-work-on-github/creating-a-label
|
||||
- /articles/customizing-issue-labels/
|
||||
- /articles/applying-labels-to-issues-and-pull-requests
|
||||
- /github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests
|
||||
- /articles/editing-a-label
|
||||
- /github/managing-your-work-on-github/editing-a-label
|
||||
- /articles/deleting-a-label
|
||||
- /github/managing-your-work-on-github/deleting-a-label
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
enterprise-server: '*'
|
||||
github-ae: '*'
|
||||
---
|
||||
|
||||
### About labels
|
||||
|
||||
You can manage your work on {% data variables.product.product_name %} by creating labels to categorize issues and pull requests. You can apply labels in the repository the label was created in. Once a label exists, you can use the label on any issue or pull request within that repository.
|
||||
|
||||
Anyone with read access to a repository can view and search the repository’s labels. To create, edit, apply, or delete a label, you must have write access to the repository.
|
||||
|
||||
### About default labels
|
||||
|
||||
{% data variables.product.product_name %} provides default labels in every new repository. You can use these default labels to help create a standard workflow in a repository.
|
||||
|
||||
Label | Description
|
||||
--- | ---
|
||||
`bug` | Indicates an unexpected problem or unintended behavior{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}
|
||||
`documentation` | Indicates a need for improvements or additions to documentation{% endif %}
|
||||
`duplicate` | Indicates similar issues or pull requests
|
||||
`enhancement` | Indicates new feature requests
|
||||
`good first issue` | Indicates a good issue for first-time contributors
|
||||
`help wanted` | Indicates that a maintainer wants help on an issue or pull request
|
||||
`invalid` | Indicates that an issue or pull request is no longer relevant
|
||||
`question` | Indicates that an issue or pull request needs more information
|
||||
`wontfix` | Indicates that work won't continue on an issue or pull request
|
||||
|
||||
Default labels are included in every new repository when the repository is created, but you can edit or delete the labels later.
|
||||
|
||||
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
|
||||
Organization owners can customize the default labels for repositories in their organization. For more information, see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)."
|
||||
{% endif %}
|
||||
|
||||
### Creating a label
|
||||
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
4. To the right of the search field, click **New label**.
|
||||
{% data reusables.project-management.name-label %}
|
||||
{% data reusables.project-management.label-description %}
|
||||
{% data reusables.project-management.label-color-randomizer %}
|
||||
{% data reusables.project-management.create-label %}
|
||||
|
||||
### Applying labels to issues and pull requests
|
||||
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.repositories.select-items-in-issue-or-pr-list %}
|
||||
4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items.
|
||||
|
||||
|
||||
### Editing a label
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
{% data reusables.project-management.edit-label %}
|
||||
{% data reusables.project-management.name-label %}
|
||||
{% data reusables.project-management.label-description %}
|
||||
{% data reusables.project-management.label-color-randomizer %}
|
||||
{% data reusables.project-management.save-label %}
|
||||
|
||||
### Deleting a label
|
||||
Deleting a label will remove the label from issues and pull requests.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-issue-pr %}
|
||||
{% data reusables.project-management.labels %}
|
||||
{% data reusables.project-management.delete-label %}
|
||||
|
||||
### Further reading
|
||||
- "[About labels](/articles/about-labels)"
|
||||
- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}
|
||||
- "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)"{% endif %}{% if currentVersion == "free-pro-team@latest" %}
|
||||
- "[Encouraging helpful contributions to your project with labels](/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels)"{% endif %}
|
||||
|
|
@ -1,8 +1,9 @@
|
|||
---
|
||||
title: Managing your work with issues
|
||||
title: Managing your work with issues and pull requests
|
||||
intro: 'You can manage your work on {% data variables.product.product_name %} by creating issues to track ideas, enhancements, tasks, or bugs.'
|
||||
mapTopic: true
|
||||
redirect_from:
|
||||
- /github/managing-your-work-on-github/managing-your-work-with-issues
|
||||
- /articles/managing-your-work-with-issues
|
||||
versions:
|
||||
free-pro-team: '*'
|
||||
Загрузка…
Ссылка в новой задаче