config-labels: restructure section about custom labels.
- Change the title from "Your Label Here" to "Customized Labels" and
reword the introductory paragraph to make it a bit clearer that it is
possible to modify existing labels in addition to defining new ones.
- Split the paragraphs about inheritance and layout into separate
sections so that they become a bit more prominent by having entries
in the table of contents.
Change-Id: I160464f389c629495d687c24db7dc75d2ad0fb16
diff --git a/Documentation/config-labels.txt b/Documentation/config-labels.txt
index 5a82d5a..682f989 100644
--- a/Documentation/config-labels.txt
+++ b/Documentation/config-labels.txt
@@ -128,9 +128,10 @@
[[label_custom]]
-== Your Label Here
+== Customized Labels
-Site administrators and project owners can also define their own labels.
+Site administrators and project owners can define their own labels,
+or customize labels inherited from parent projects.
See above for descriptions of how <<label_Verified,`Verified`>>
and <<label_Code-Review,`Code-Review`>> work, and add your own
@@ -144,11 +145,19 @@
permission editor web UI.
Labels may be added to any project's `project.config`; the default
-labels are defined in `All-Projects`. Labels are inherited from parent
-projects; a child project may add, override, or remove labels defined in
-its parents. Overriding a label in a child project overrides all its
-properties and values. To remove a label in a child project, add an
-empty label with the same name as in the parent.
+labels are defined in `All-Projects`.
+
+[[label_inheritance]]
+=== Inheritance
+
+Labels are inherited from parent projects. A child project may add,
+override, or remove labels defined in its parents. Overriding a label
+in a child project overrides all its properties and values. To remove
+a label in a child project, add an empty label with the same name as
+in the parent.
+
+[[label_layout]]
+=== Layout
Labels are laid out in the order they are specified in project.config,
with inherited labels appearing first, providing some layout control to
