e910868657
This tries to resolve the confusing points about labeling, such as, where to add new labels. The article is not very descriptive due to Forgejo already having a more detailed documentation regarding labels.
2.7 KiB
| eleventyNavigation | ||||||||
|---|---|---|---|---|---|---|---|---|
|
{% admonition "note" %}
For more detailed information on labels and how to use them, see Forgejo's documentation
{% endadmonition %}
Labels act as indicators and categorise issues for specific groups. Labelling makes it quick and easy for, for example, developers to glance over an issue and detect whether it falls into a category that is relevant to them.
Adding a Label Presets
Label presets are simply a group of predetermined labels that are often used in projects. When you choose to use a label preset, you can access multiple labels at once, so you don't need to create them one by one unless you absolutely have to.
There are two label presets to choose from:
- Default — Recommended for most usecases
- Advanced — For larger and more complex projects
During Repository Creation
This section will only demonstrate how to add labels when creating a new repository. If you are unfamiliar with repositories or how they are created, please refer to the section Your First Repository.
When creating a new repository, you will see an 'Advanced settings' section at the bottom and an expandable button labelled 'Click to expand'. Click on this button. This will expand to give you the option to click on a button that says 'Select a label set'. After clicking this, you should see the following:
TODO SCREENSHOT [of label preset selection view (Advanced settings>Labels section) when creating a new repository]
Once you have created your repository with your chosen preset, you can start using them on the issues. You won't need to take further action.
{% admonition "tip" %}
Adding a label set during repository creation does not mean that you are restricted to using only the labels shown during the selection process. You can add more later.
{% endadmonition %}
To an Existing Repository
You can add label presets to an existing repository. To find out where these label presets are added by looking at Label Management,
Once you are in the correct location, the selection with look like this:
TODO SCREENSHOT [of label preset selection view in an existing repository]
Label Management
TODO SCREENSHOT [of label management view under Issues>Labels]
Adding Labels
TODO SCREENSHOT [of the "New Label" button location]
TODO SCREENSHOT [of "New label" view]
Editing Labels
TODO SCREENSHOT [of the "Edit" button location]
TODO SCREENSHOT [of "Edit label" view]
Deleting Labels
TODO SCREENSHOT [of the "Delete" button location]
TODO SCREENSHOT [of "Delete label" view]