Date: Tue, 28 Nov 2017 16:40:06 +0000 From: Alexey Dokuchaev <danfe@FreeBSD.org> To: Adam Weinberger <adamw@adamw.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: <20171128164006.GC43542@FreeBSD.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 Tue, Nov 28, 2017 at 09:26:55AM -0700, Adam Weinberger wrote: > > On 28 Nov, 2017, at 9:19, Alexey Dokuchaev <danfe@FreeBSD.org> wrote: > > On Tue, Nov 28, 2017 at 04:12:32PM +0000, Dan Langille wrote: > >> [...] > >> +COMMENT= 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) > > > > 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. Big +1, I appreciate the support Adam. > Folks, the descr is our catalogue; it's the first place that end-users > learn about ports and decide which one they're looking for. Take the 2 > minutes to write a meaningful description, [...] Exactly. I can give an advice: if upstream lacks elaborate description, and you're having difficulty coming up with one of your own, take a look at some GNU/Linux distros that provide the same (or similar) package. I recall adding `sysutils/radeontop' and not being happy with pkg-descr (in r436717) until I found better description in Linux Mint package, cf. r436868. HTH, ./danfe
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20171128164006.GC43542>