Date: Mon, 8 Feb 2016 12:18:19 +1100 From: Greg 'groggy' Lehey <grog@FreeBSD.org> To: Torsten =?iso-8859-1?Q?Z=FChlsdorff?= <mailinglists@toco-domains.de> Cc: ports@freebsd.org Subject: Re: Removing documentation Message-ID: <20160208011819.GE71035@eureka.lemis.com> In-Reply-To: <56B72E20.80909@toco-domains.de> References: <20160207000304.GA71035@eureka.lemis.com> <56B72E20.80909@toco-domains.de>
next in thread | previous in thread | raw e-mail | index | archive | help
--Zi0sgQQBxRFxMTsj Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sunday, 7 February 2016 at 12:44:32 +0100, Torsten Z=FChlsdorff wrote: > Hello, > >>> You have a tool presented as "official" that hasn't had it's >>> original maintainer in 4 years and was only kept on life support up >>> until 9 months ago. >> >> Agreed, the "official" (the term used is "recommended") status is >> gone. But that's a reason to fix the documentation, not remove it. >> As I see it, we have three choices, in increasing order of >> desirability: >> >> 1. Remove all mention of portmaster. That's what this PR recommends. >> 2. Do nothing. >> 3. Update the documentation to indicate the current status, >> recommending alternatives if possible. > > Number 4 is missing: find a maintainer for it. Yes. It was there in my draft, and I removed it. It's a separate issue: I was asking here about what to do with documentation for used, but unmaintained packages. But you make a good point: if there's a lapse in maintainership, and the product then becomes maintained again, you don't want to lose the documentation. Greg -- Sent from my desktop computer. Finger grog@FreeBSD.org for PGP public key. See complete headers for address and phone numbers. This message is digitally signed. If your Microsoft MUA reports problems, please read http://tinyurl.com/broken-mua --Zi0sgQQBxRFxMTsj Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAla37NsACgkQIubykFB6QiP/JwCdHLdQ71XgxD2Pu3mG2iLdffT4 2YEAoJ0/m7FzLAasOA1gvTAx2fXjvB9h =DY3N -----END PGP SIGNATURE----- --Zi0sgQQBxRFxMTsj--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20160208011819.GE71035>