From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 59EFF138350 for ; Wed, 22 Jan 2020 03:50:51 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 5E231E08DD; Wed, 22 Jan 2020 03:50:47 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 47763E08DD for ; Wed, 22 Jan 2020 03:50:47 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 65F8F34E3CA for ; Wed, 22 Jan 2020 03:50:45 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C68CA9C for ; Wed, 22 Jan 2020 03:33:21 +0000 (UTC) From: "Michał Górny" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Michał Górny" Message-ID: <1579662329.5d3972de21bc06154fc3e1c6b8bb4041457e4dae.mgorny@gentoo> Subject: [gentoo-commits] proj/policy-guide:master commit in: / X-VCS-Repository: proj/policy-guide X-VCS-Files: other-metadata.rst X-VCS-Directories: / X-VCS-Committer: mgorny X-VCS-Committer-Name: Michał Górny X-VCS-Revision: 5d3972de21bc06154fc3e1c6b8bb4041457e4dae X-VCS-Branch: master Date: Wed, 22 Jan 2020 03:33:21 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 9be75c91-7c5d-4dfd-8479-fbeec60f0774 X-Archives-Hash: 1d22cac1a8292ae5975b6bd58159f9ca commit: 5d3972de21bc06154fc3e1c6b8bb4041457e4dae Author: Michał Górny gentoo org> AuthorDate: Sun Jan 19 17:56:55 2020 +0000 Commit: Michał Górny gentoo org> CommitDate: Wed Jan 22 03:05:29 2020 +0000 URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=5d3972de other-metadata: meaningful homepage policy Closes: https://bugs.gentoo.org/705866 Closes: https://github.com/gentoo/policy-guide/pull/7 Signed-off-by: Michał Górny gentoo.org> other-metadata.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) 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; gentoo.org + +HOMEPAGE value must be meaningful +--------------------------------- +:Source: QA +:Reference: https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035 +: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 ``https://www.gentoo.org/`` +or a similar generic homepage. If no homepage is available, the special +value of ``https://wiki.gentoo.org/wiki/No_homepage`` 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: https://projects.gentoo.org/pms/7/pms.html#x1-600007.1