From owner-freebsd-ports@freebsd.org Mon Feb 8 01:18:21 2016 Return-Path: Delivered-To: freebsd-ports@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 7D5FCAA0618 for ; Mon, 8 Feb 2016 01:18:21 +0000 (UTC) (envelope-from grog@lemis.com) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id 684B61947 for ; Mon, 8 Feb 2016 01:18:21 +0000 (UTC) (envelope-from grog@lemis.com) Received: by mailman.ysv.freebsd.org (Postfix) id 670B8AA0617; Mon, 8 Feb 2016 01:18:21 +0000 (UTC) Delivered-To: ports@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 66A50AA0616 for ; Mon, 8 Feb 2016 01:18:21 +0000 (UTC) (envelope-from grog@lemis.com) Received: from www.lemis.com (www.lemis.com [208.86.226.86]) by mx1.freebsd.org (Postfix) with ESMTP id 447811946 for ; Mon, 8 Feb 2016 01:18:21 +0000 (UTC) (envelope-from grog@lemis.com) Received: from eureka.lemis.com (www.lemis.com [208.86.226.86]) by www.lemis.com (Postfix) with ESMTP id 5C3AD1B72802; Mon, 8 Feb 2016 01:18:20 +0000 (UTC) Received: by eureka.lemis.com (Postfix, from userid 1004) id 4C44844A5F0; Mon, 8 Feb 2016 12:18:19 +1100 (AEDT) Date: Mon, 8 Feb 2016 12:18:19 +1100 From: Greg 'groggy' Lehey To: Torsten =?iso-8859-1?Q?Z=FChlsdorff?= Cc: ports@freebsd.org Subject: Re: Removing documentation Message-ID: <20160208011819.GE71035@eureka.lemis.com> References: <20160207000304.GA71035@eureka.lemis.com> <56B72E20.80909@toco-domains.de> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Zi0sgQQBxRFxMTsj" Content-Disposition: inline In-Reply-To: <56B72E20.80909@toco-domains.de> Organization: The FreeBSD Project Phone: +61-3-5346-1370, +61-3-5309-0418 Mobile: 0401 265 606. Use only as instructed. WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 User-Agent: Mutt/1.5.24 (2015-08-30) X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Feb 2016 01:18:21 -0000 --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--