svn commit: r455056 - head/devel/py-naiveBayesClassifier

[Adam Weinberger]

> On 28 Nov, 2017, at 9:19, Alexey Dokuchaev <danfe at FreeBSD.org> wrote:
> 
> On Tue, Nov 28, 2017 at 04:12:32PM +0000, Dan Langille wrote:
>> New Revision: 455056
>> URL: https://svnweb.freebsd.org/changeset/ports/455056
>> 
>> Log:
>>  Yet another general purpose Naive Bayesian classifier. (under heavy
>>  development)
>> 
>> [...]
>> +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.

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, and for crying out loud include a WWW link.

# Adam


-- 
Adam Weinberger
adamw at adamw.org
https://www.adamw.org