Date: Tue, 28 Nov 2017 11:38:11 -0500 From: Dan Langille <dan@langille.org> To: Adam Weinberger <adamw@adamw.org> Cc: Alexey Dokuchaev <danfe@FreeBSD.org>, 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: <0B3B3B9E-F5AF-4788-B7DF-7C0DC79D0B2E@langille.org> In-Reply-To: <028241A0-ED33-4BF2-BC3F-F723B00072EB@adamw.org> References: <201711281612.vASGCWJI056613@repo.freebsd.org> <20171128161915.GB43542@FreeBSD.org> <028241A0-ED33-4BF2-BC3F-F723B00072EB@adamw.org>
next in thread | previous in thread | raw e-mail | index | archive | help
> On Nov 28, 2017, at 11:26 AM, Adam Weinberger <adamw@adamw.org> wrote: >=20 >> 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). >=20 > 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. >=20 > 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. >=20 Both Adam and Alexey are correct. I will fix today. Thank you. --=20 Dan Langille - BSDCan / PGCon dan@langille.org
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?0B3B3B9E-F5AF-4788-B7DF-7C0DC79D0B2E>