Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 8 Aug 2018 17:57:02 -0400
From:      Ryan Steinmetz <zi@freebsd.org>
To:        Mathieu Arnold <mat@freebsd.org>
Cc:        Adam Weinberger <adamw@adamw.org>, ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org
Subject:   Re: svn commit: r476670 - in head/devel: . rubygem-solve
Message-ID:  <20180808215702.GB52659@exodus.zi0r.com>
In-Reply-To: <20180808213446.gktmjqcyrfhjkrlk@atuin.in.mat.cc>
References:  <201808081953.w78Jr68X078029@repo.freebsd.org> <CAP7rwciJj9U0TOEvnwSCc2hCWh_NF44pPjHfmQRu8MGCYq24AA@mail.gmail.com> <20180808202929.GA63276@exodus.zi0r.com> <20180808213446.gktmjqcyrfhjkrlk@atuin.in.mat.cc>

next in thread | previous in thread | raw e-mail | index | archive | help

On (08/08/18 23:34), Mathieu Arnold wrote:
>> > Ryan,
>> >
>> > You've just added a number of ports with uninformative pkg-descrs, and
>> > unhelpful COMMENT strings. These aren't merely formalities. Users
>> > should be able to read the pkg-descr and understand if it's the right
>> > package for them, and COMMENT is the first target for searches.
>> > Please, go back over them and, at the very least, expand the pkg-descr
>> > files with more information. As a general rule, pkg-descr should NEVER
>> > be the same text as the COMMENT.
>>
>> Adam,
>>
>> These are the description strings from authors of the code.  They came from
>> either rubygems.org and/or the gem source repository.  For example, in the
>> case of rubygem-solve:
>>
>> https://rubygems.org/gems/solve
>>
>> https://github.com/berkshelf/solve
>>
>> If you have any specific things you would like to see added to any of the
>> individual ports, please let me know.
>
>pkg-descr must contain sentences, something that can be read. It must at
>least be two lines long, so that it is descriptive enough.  The fact
>that upstream is crappy does not mean you can put he same crap in the
>ports tree.  It is your job as committer to make sure that ports conform
>to our policies and requirements.  If upstream does not provide a better
>decription, create one, basd on your knowledge of the software.


https://svnweb.freebsd.org/ports/head/devel/p5-Data-Serializer-Sereal/pkg-descr?revision=401986&view=markup

https://svnweb.freebsd.org/ports/head/net/rubygem-epp-client-afnic/pkg-descr?revision=380380&view=markup

https://svnweb.freebsd.org/ports/head/net/rubygem-epp-client-smallregistry/pkg-descr?view=markup

https://svnweb.freebsd.org/ports/head/net/rubygem-epp-client-secdns/pkg-descr?revision=380380&view=markup


-r


>
>-- 
>Mathieu Arnold



-- 
Ryan Steinmetz
PGP: 9079 51A3 34EF 0CD4 F228  EDC6 1EF8 BA6B D028 46D7



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20180808215702.GB52659>