aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2021-06-18 06:03:31 +0100
committerSam James <sam@gentoo.org>2021-08-01 03:38:39 +0100
commit8efea8b918e6b9f12d8612ed4c9bb498fcdbd33a (patch)
tree7554a53fe93163906a39781eac02033730aff4aa /ebuild-writing
parentebuild-writing/common-mistakes: add 'Calling pkg-config directly' (diff)
downloaddevmanual-8efea8b918e6b9f12d8612ed4c9bb498fcdbd33a.tar.gz
devmanual-8efea8b918e6b9f12d8612ed4c9bb498fcdbd33a.tar.bz2
devmanual-8efea8b918e6b9f12d8612ed4c9bb498fcdbd33a.zip
ebuild-writing/common-mistakes: reformat 'DESCRIPTION and HOMEPAGE'
Closes: https://github.com/gentoo/devmanual/pull/223 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/common-mistakes/text.xml9
1 files changed, 5 insertions, 4 deletions
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
index cc87d74..e46a36c 100644
--- a/ebuild-writing/common-mistakes/text.xml
+++ b/ebuild-writing/common-mistakes/text.xml
@@ -413,11 +413,12 @@ SLOT="0"
<body>
<p>
+Make sure the <c>DESCRIPTION</c> is not overly long. Good descriptions will
+describe the main function of the package in a sentence.
+
Please check if the <c>HOMEPAGE</c> variable is right and leads users to the
-right page if they want to find out more about the package. And make sure
-the <c>DESCRIPTION</c> is not overly long. Good descriptions will describe
-the main function of the package in a sentence. If no homepage for the package
-is available, set the <c>HOMEPAGE</c> variable to
+right page if they want to find out more about the package. If no homepage for
+the package is available, set the <c>HOMEPAGE</c> variable to
<c>https://wiki.gentoo.org/wiki/No_homepage</c>. Please also strive to test
HTTPS support for the site used in <c>HOMEPAGE</c>.
</p>