aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2024-04-29 23:22:48 +0200
committerUlrich Müller <ulm@gentoo.org>2024-05-07 19:21:45 +0200
commitc09e7231f8c24cc0235abd494d8849a24138b76c (patch)
treebbb14b99fcd952673546d3972f774250820ab1d0
parentMore sentence case changes (diff)
downloaddevmanual-c09e7231f8c24cc0235abd494d8849a24138b76c.tar.gz
devmanual-c09e7231f8c24cc0235abd494d8849a24138b76c.tar.bz2
devmanual-c09e7231f8c24cc0235abd494d8849a24138b76c.zip
devbook-guide: Document that sentence case should be used in titles
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
-rw-r--r--appendices/devbook-guide/text.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml
index 5c4aec7..c725307 100644
--- a/appendices/devbook-guide/text.xml
+++ b/appendices/devbook-guide/text.xml
@@ -697,6 +697,12 @@ with a capital letter.
</codesample>
<p>
+Titles should use sentence case, i.e. their first word should start with a
+capital letter, and all other words (except proper nouns) should be in lower
+case.
+</p>
+
+<p>
Try to use <c>&lt;uri&gt;</c> with the <c>link</c> attribute as much as
possible. In other words, the
<uri link="https://www.gentoo.org/">Gentoo website</uri> is preferred over