a06ea17a4b
* Move directory to new location * Update new index page * Create wikis category * Create blocking category * Create moderation category * Make map topics into category indexes * Create contributions category * Create template category * Add redirects * Add new product to products.yml * Rename product for URL purposes * Update links to wiki content * Update links to maintaining safety articles * Update links to moderation content * Remove old category from github product index * Fix links * Update links to healthy contributions articles * Update links to template articles * Fix links
5.2 KiB
title, intro, redirect_from, versions, topics
| title | intro | redirect_from | versions | topics | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Managing labels | You can classify issues and pull requests by creating, editing, applying, and deleting labels. |
|
|
|
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. Anyone with triage access to a repository can apply/dismiss existing 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." {% 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
- "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"{% endif %}{% if currentVersion == "free-pro-team@latest" %}
- "Encouraging helpful contributions to your project with labels"{% endif %}