svn commit: r341401 - head/www/py-requests1

Alexey Dokuchaev danfe at FreeBSD.org
Mon Jan 27 14:34:57 UTC 2014


On Tue, Jan 28, 2014 at 01:18:35AM +1100, Kubilay Kocak wrote:
> By default, most Python maintainers use the short description found in
> either the modules setup.py metadata, or the short tag/summary from the
> projects site verbatim, unless there is good reason to do so. In this
> case: http://docs.python-requests.org/en/latest/ [...]
> 
> For what it's worth, "for human beings" is almost a convention in Python
> land for modules with 'beautiful developer API\'s'

Right, in Python land it is.  However, as a generic packager (that is,
FreeBSD Project) we should provide package descriptions (that includes
both COMMENT and pkg-descr) that can be comprehended by anyone, not just
someone necessarily coming from the Python land.

In this particular case, more neutral COMMENT, like "convenient (or easy
to use) HTTP module/functions bundle" would IMHO be better.

This is just my nit picking of course; no need to take any immediate
action(s).

./danfe


More information about the svn-ports-all mailing list