diff options
authorMichał Górny <>2020-01-19 18:56:55 +0100
committerMichał Górny <>2020-01-22 04:05:29 +0100
commit5d3972de21bc06154fc3e1c6b8bb4041457e4dae (patch)
parentdependencies: policy on 4-style USE deps (diff)
other-metadata: meaningful homepage policy
Closes: Closes: Signed-off-by: Michał Górny <>
1 files changed, 27 insertions, 0 deletions
diff --git a/other-metadata.rst b/other-metadata.rst
index ca3759a..61749cb 100644
--- a/other-metadata.rst
+++ b/other-metadata.rst
@@ -36,4 +36,31 @@ manager behavior which could include use of unpredictable slot, cache
invalidation or explicit errors.
+.. index::
+ single: homepage; meaningful value
+ pair: homepage;
+HOMEPAGE value must be meaningful
+:Source: QA
+:Reported: known bad values are reported by pkgcheck
+The HOMEPAGE specified for the package should either be dedicated
+to the package in question or make it easy to find dedicated
+information. Packages must not use ````
+or a similar generic homepage. If no homepage is available, the special
+value of ```` must be used.
+*Rationale*: The homepage specified in ebuilds is normally used to
+locate information about the upstream project, e.g. downloads, source
+code repository, bug tracker, documentation. Homepages that make it
+hard to locate information about a specific project have little value,
+and the Gentoo homepage generally does not do a good job at linking even
+major Gentoo projects. Furthermore, many of the projects did not even
+have a single dedicated subpage anywhere in Gentoo web space. In all
+those cases, using the explicit No_homepage marker at least makes it
+easy to identify such packages.
.. _metadata invariance: