Date: Tue, 28 Jan 2014 13:28:58 +0400 From: Ruslan Makhmatkhanov <cvs-src@yandex.ru> To: Alexey Dokuchaev <danfe@FreeBSD.org>, koobs@FreeBSD.org Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org Subject: Re: svn commit: r341401 - head/www/py-requests1 Message-ID: <52E7785A.1070804@yandex.ru> In-Reply-To: <20140127143457.GB71123@FreeBSD.org> References: <201401271318.s0RDInCu014881@svn.freebsd.org> <20140127140508.GA68244@FreeBSD.org> <52E66ABB.5000002@FreeBSD.org> <20140127143457.GB71123@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Alexey Dokuchaev wrote on 27.01.2014 18:34: > 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 It's doubtful that Joe Average occasionally getting this port as dependency will ever care about what it does. While to "someone coming from the Python land" the meaning of it would be quite obvious. -- Regards, Ruslan T.O.S. Of Reality
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52E7785A.1070804>