Date: Tue, 28 Nov 2017 09:26:55 -0700 From: Adam Weinberger <adamw@adamw.org> To: Alexey Dokuchaev <danfe@FreeBSD.org> Cc: Dan Langille <dvl@FreeBSD.org>, ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org Subject: Re: svn commit: r455056 - head/devel/py-naiveBayesClassifier Message-ID: <028241A0-ED33-4BF2-BC3F-F723B00072EB@adamw.org> In-Reply-To: <20171128161915.GB43542@FreeBSD.org> References: <201711281612.vASGCWJI056613@repo.freebsd.org> <20171128161915.GB43542@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
> On 28 Nov, 2017, at 9:19, Alexey Dokuchaev <danfe@FreeBSD.org> wrote: >=20 > On Tue, Nov 28, 2017 at 04:12:32PM +0000, Dan Langille wrote: >> New Revision: 455056 >> URL: https://svnweb.freebsd.org/changeset/ports/455056 >>=20 >> Log: >> Yet another general purpose Naive Bayesian classifier. (under heavy >> development) >>=20 >> [...] >> +COMMENT=3D Yet another general purpose naive bayesian classifier >> [...] >> +++ head/devel/py-naiveBayesClassifier/pkg-descr >> @@ -0,0 +1,4 @@ >> +yet another general purpose Naive Bayesian classifier. >> +(under heavy development) >=20 > Inconsistent capitalization in COMMENT vs. pkg-descr; also, typically > port description text should contain a little more information about > the port (see section 3.2.1 of the PHB for some hints). This is something that we have really regressed on lately. Our = pkg-descrs are becoming very terse, often simply repeating the COMMENT. = Someone, I forget who, recently added a bunch of ports without even = listing WWW. We have many ports broken into sections or variants where = they all share the same descr, so now I have no idea which one I = actually want to install. Folks, the descr is our catalogue; it=E2=80=99s the first place that = end-users learn about ports and decide which one they=E2=80=99re looking = for. Take the 2 minutes to write a meaningful description, and for = crying out loud include a WWW link. # Adam --=20 Adam Weinberger adamw@adamw.org https://www.adamw.org
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?028241A0-ED33-4BF2-BC3F-F723B00072EB>