From e910868657dabb682bd8a8742ea9ce2f792d5d37 Mon Sep 17 00:00:00 2001
From: spuzkov <spuzkov@tuta.com>
Date: Tue, 10 Mar 2026 22:46:31 +0200
Subject: [PATCH] Created a new article about issue labeling

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.
---
 content/collaborating/labeling-issues.md | 76 ++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 content/collaborating/labeling-issues.md

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]
+