diff --git a/content/collaborating/labeling-issues.md b/content/collaborating/labeling-issues.md new file mode 100644 index 0000000..a314f1c --- /dev/null +++ b/content/collaborating/labeling-issues.md @@ -0,0 +1,76 @@ +--- +eleventyNavigation: + key: LabelingIssues + title: Labeling Issues + parent: Collaborating + order: 70 +--- + +{% admonition "note" %} + +For more detailed information on labels and how to use them, see [Forgejo's documentation](https://forgejo.org/docs/latest/user/labels/) + +{% 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](https://docs.codeberg.org/getting-started/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](#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] +