From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-dev+bounces-89476-garchives=archives.gentoo.org@lists.gentoo.org>
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 25B85138334
	for <garchives@archives.gentoo.org>; Wed,  4 Dec 2019 12:36:18 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id AEC78E0831;
	Wed,  4 Dec 2019 12:36:13 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
	(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 4ADD5E0821
	for <gentoo-dev@lists.gentoo.org>; Wed,  4 Dec 2019 12:36:13 +0000 (UTC)
Received: from pomiot (c134-66.icpnet.pl [85.221.134.66])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(No client certificate requested)
	(Authenticated sender: mgorny)
	by smtp.gentoo.org (Postfix) with ESMTPSA id 58A3E34D7BB;
	Wed,  4 Dec 2019 12:36:11 +0000 (UTC)
Message-ID: <0ebb1850c54ab69714e4f5e3525e8a40c74cb519.camel@gentoo.org>
Subject: [gentoo-dev] Usefulness of HOMEPAGE=https://www.gentoo.org
From: =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?= <mgorny@gentoo.org>
To: gentoo-dev <gentoo-dev@lists.gentoo.org>
Date: Wed, 04 Dec 2019 13:36:07 +0100
Organization: Gentoo
Content-Type: multipart/signed; micalg="pgp-sha512";
	protocol="application/pgp-signature"; boundary="=-HiU4zZmdWaqjNAD5NOvw"
User-Agent: Evolution 3.32.4 
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
MIME-Version: 1.0
X-Archives-Salt: 8146b4b4-7847-45b7-baa8-76ba9cd79c26
X-Archives-Hash: 83cc5bbd7bbe8bdf04dd3c3bc7f8a035


--=-HiU4zZmdWaqjNAD5NOvw
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi,

Many of Gentoo-originating packages are listing the main Gentoo site
as HOMEPAGE.  In my opinion, this is suboptimal (not to say 'useless').

I can think of a few uses for HOMEPAGE:

1. providing additional information about the package (before the user
chooses it),

2. providing easy access to (additional) documentation,

3. providing easy access to package sources,

4. providing easy access to bug reporting,

5. providing easy access to downloads.

A good HOMEPAGE is dedicated to the package in question, and makes it
easy to find all the stuff (and all other stuff the user might need).
The more effort user needs to put into finding what he needs, the worse
HOMEPAGE is.

Now, if I consider gentoo.org as a HOMEPAGE for ~90 packages it
currently is, it's horribly bad.  I suppose that in some cases authors
meant to indicate that Gentoo is the package's upstream.  However, by
going to the main Gentoo site, it's *very hard* to find anything about
the package in question.

Just please select a totally random package from those listing
gentoo.org as HOMEPAGE, then go to gentoo.org and try to find either
of the points listed above.  If you click 'Downloads', you're certainly
not going to find anything relevant.  Through 'Support', you may
eventually find that tiny Bugzilla button at the bottom... and then try
to find the correct Product.  You may also find gitweb link somewhere,
and try to see if the project has a repo there.  Or maybe it's somewhere
else, or maybe it existed on somebody's devspace once.

My point is: gentoo.org as a HOMEPAGE sucks.  Please use something more
specific instead.  Even link to gitweb would be more helpful because it
would at least be relevant to the package in question.

--=20
Best regards,
Micha=C5=82 G=C3=B3rny


--=-HiU4zZmdWaqjNAD5NOvw
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----

iQGTBAABCgB9FiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAl3nqDdfFIAAAAAALgAo
aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldEM3
NkE4NDUwOTQwOThEMjhDQzhCMjZDNTYzOUFEQUUyMzI5RTI0MEUACgkQY5ra4jKe
JA53mQgAr/8b3R8W6R+Nl7BUoL7WHQYZb3ZuULB3UlUX999F3gDYT/ZVRM9jUXUK
z4KYqD7HZe8WIf1cxOeHkIGVVZlE/MzHC34bpaZNFb40W7045AXtifBS4zbcKvtq
ShUwJzqv5pOl1A4oTQY2MsZrA8ds0N8e37Rp1zCK6UjS/WzZjyZpnAxwHy5R/VCE
JRTj1GJYqJGiTLyc9BsfnsbhzLzfFxNnmsGw29eU9JDX/WQT9WjaQK0Ci86uM4i3
i+xbAn4MygaM4caFs2crfwX/2fs+VHmaGmrgVHLbFubnzJUpV7D4oev3Heu7Kz1V
1vnDomSEgCXqdbQGF+kIy5GQXBKe1A==
=G16m
-----END PGP SIGNATURE-----

--=-HiU4zZmdWaqjNAD5NOvw--