Re: [Distutils] Requesting PyPI classifiers for Sphinx
Thanks Fred, Richard. I'll announce it to sphinx-users and developers. I'll also change sphinx-contrib package template https://bitbucket.org/birkenfeld/sphinx-contrib/src/tip/_template/ and update several tutorials. Thanks, On Thu Nov 27 2014 at 7:32:13 Richard Jones wrote: > On Thu Nov 27 2014 at 9:26:24 AM Fred Drake wrote: > >> On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones >> wrote: >> > Do you have any idea of the number of existing packages that would fit >> under >> > each of those categories? I'm only asking because I wonder whether we >> need >> > all four right now. >> >> A quick search using the PyPI search box suggests there are a *lot* of >> extensions (a couple of hundred?) and even themes (dozens; more than I >> expected). I'm not sure how to search for sphinx-related software >> other than extensions or themes with that UI. >> >> I was surprised at just how many relevant packages were listed (a >> testament to Sphinx's well-deserved success); I suspect the categories >> are justified. Getting the appropriate package maintainers to be >> aware of and apply them is another matter. That gets back to the >> guidance question, which is really separate from this. >> >> >> -Fred >> >> -- >> Fred L. Drake, Jr. >> "A storm broke loose in my mind." --Albert Einstein >> > ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
Thanks for that, Fred. I've added all four classifiers. Richard On Thu Nov 27 2014 at 9:26:24 AM Fred Drake wrote: > On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones wrote: > > Do you have any idea of the number of existing packages that would fit > under > > each of those categories? I'm only asking because I wonder whether we > need > > all four right now. > > A quick search using the PyPI search box suggests there are a *lot* of > extensions (a couple of hundred?) and even themes (dozens; more than I > expected). I'm not sure how to search for sphinx-related software > other than extensions or themes with that UI. > > I was surprised at just how many relevant packages were listed (a > testament to Sphinx's well-deserved success); I suspect the categories > are justified. Getting the appropriate package maintainers to be > aware of and apply them is another matter. That gets back to the > guidance question, which is really separate from this. > > > -Fred > > -- > Fred L. Drake, Jr. > "A storm broke loose in my mind." --Albert Einstein > ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
On Wed Nov 26 2014 at 9:47:07 PM Takayuki Shimizukawa wrote: > Hi Fred, > > On Tue Nov 25 2014 at 23:12:14 Fred Drake wrote: > >> On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa >> wrote: >> > I'd like to request classifiers for the Sphinx like: >> > >> > "Topic :: Documentation :: Sphinx" >> > "Topic :: Documentation :: Sphinx :: Extension" >> >> I suspect adding "Framework :: Sphinx" would make more sense for >> extensions. For tools used with Sphinx documentation without being >> tied to the Sphinx application itself, "Topic :: Documentation :: >> Sphinx" seems fine. (I'd imagine an extension would specify both, and >> non-extension tools would use only "Topic :: Documentation :: >> Sphinx".) >> > > Thanks for the suggestion. It make sense to me too. > How about this? > > "Topic :: Documentation :: Sphinx" > "Framework :: Sphinx" > "Framework :: Sphinx :: Extension" > "Framework :: Sphinx :: Theme" > Do you have any idea of the number of existing packages that would fit under each of those categories? I'm only asking because I wonder whether we need all four right now. Richard ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones wrote: > Do you have any idea of the number of existing packages that would fit under > each of those categories? I'm only asking because I wonder whether we need > all four right now. A quick search using the PyPI search box suggests there are a *lot* of extensions (a couple of hundred?) and even themes (dozens; more than I expected). I'm not sure how to search for sphinx-related software other than extensions or themes with that UI. I was surprised at just how many relevant packages were listed (a testament to Sphinx's well-deserved success); I suspect the categories are justified. Getting the appropriate package maintainers to be aware of and apply them is another matter. That gets back to the guidance question, which is really separate from this. -Fred -- Fred L. Drake, Jr. "A storm broke loose in my mind." --Albert Einstein ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
On Thu Nov 27 2014 at 9:08:40 AM Donaldo Fastoso wrote: > Somewhat OT, > > but i was wondering if there is documentation helping to choose > the right classifiers if the choice is not obvious. > > For example i find the "Development Status" classifiers somewhat > "quirky": 3 classifiers for alpha-releases: > > Development Status :: 1 - Planning > Development Status :: 2 - Pre-Alpha > Development Status :: 3 - Alpha > > but no "release candidate" > I'm not sure that's a level of granularity that the cheese shop really needs. Release candidates can be tagged "beta". > > Development Status :: 4 - Beta > Development Status :: 5 - Production/Stable > > and similar to the alphas a somewhat murky distinction between the > stables: > > Development Status :: 5 - Production/Stable > Development Status :: 6 - Mature > That is a somewhat murky distinction, yes. In my mind mature applies to packages that have been stable for a long time and have not had any significant work done on them. Something like gadfly, for example :) > And on a second thought: is there a way to deprecate classifiers if > they get obsolete? > No, they're there for liff :) Richard ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
Somewhat OT, but i was wondering if there is documentation helping to choose the right classifiers if the choice is not obvious. For example i find the "Development Status" classifiers somewhat "quirky": 3 classifiers for alpha-releases: Development Status :: 1 - Planning Development Status :: 2 - Pre-Alpha Development Status :: 3 - Alpha but no "release candidate" Development Status :: 4 - Beta Development Status :: 5 - Production/Stable and similar to the alphas a somewhat murky distinction between the stables: Development Status :: 5 - Production/Stable Development Status :: 6 - Mature What is the rationale behind this and where can i inform myself about it? And on a second thought: is there a way to deprecate classifiers if they get obsolete? ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
On Wed, Nov 26, 2014 at 5:46 AM, Takayuki Shimizukawa wrote: > How about this? > > "Topic :: Documentation :: Sphinx" > "Framework :: Sphinx" > "Framework :: Sphinx :: Extension" > "Framework :: Sphinx :: Theme" +1 -Fred -- Fred L. Drake, Jr. "A storm broke loose in my mind." --Albert Einstein ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
Hi Fred, On Tue Nov 25 2014 at 23:12:14 Fred Drake wrote: > On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa > wrote: > > I'd like to request classifiers for the Sphinx like: > > > > "Topic :: Documentation :: Sphinx" > > "Topic :: Documentation :: Sphinx :: Extension" > > I suspect adding "Framework :: Sphinx" would make more sense for > extensions. For tools used with Sphinx documentation without being > tied to the Sphinx application itself, "Topic :: Documentation :: > Sphinx" seems fine. (I'd imagine an extension would specify both, and > non-extension tools would use only "Topic :: Documentation :: > Sphinx".) > Thanks for the suggestion. It make sense to me too. How about this? "Topic :: Documentation :: Sphinx" "Framework :: Sphinx" "Framework :: Sphinx :: Extension" "Framework :: Sphinx :: Theme" Regards, -- Takayuki Shimizukawa http://about.me/shimizukawa ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa wrote: > I'd like to request classifiers for the Sphinx like: > > "Topic :: Documentation :: Sphinx" > "Topic :: Documentation :: Sphinx :: Extension" I suspect adding "Framework :: Sphinx" would make more sense for extensions. For tools used with Sphinx documentation without being tied to the Sphinx application itself, "Topic :: Documentation :: Sphinx" seems fine. (I'd imagine an extension would specify both, and non-extension tools would use only "Topic :: Documentation :: Sphinx".) -Fred -- Fred L. Drake, Jr. "A storm broke loose in my mind." --Albert Einstein ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
+1 --Danny On Nov 24, 2014 5:07 PM, "Takayuki Shimizukawa" wrote: > Bump. > > I'd like to request trove classifiers for the Sphinx like: > > "Topic :: Documentation :: Sphinx" > "Topic :: Documentation :: Sphinx :: Extension" > > And additionally: > > "Topic :: Documentation :: Sphinx :: Theme" > > Thanks. > > On Thu Nov 20 2014 at 0:16:21 Takayuki Shimizukawa > wrote: > >> Hi, >> >> I'd like to request classifiers for the Sphinx like: >> >> "Topic :: Documentation :: Sphinx" >> "Topic :: Documentation :: Sphinx :: Extension" >> >> It would help us to search sphinx extensions and sphinx related tools. >> .. ex. sphinx-intl, sphinx-testing, Tinkerer, and sphinx extensions. >> .. refs: "[sphinx-users]: Survey of Sphinx extensions" [1]_ [2]_ >> >> Thanks. >> >> .. [1] https://groups.google.com/d/msg/sphinx-users/p82dKvqCUck/ >> BBoavGgXRcwJ >> .. [2] http://sphinxext-survey.readthedocs.org/en/latest/ >> -- >> Takayuki SHIMIZUKAWA >> http://about.me/shimizukawa >> > > ___ > Distutils-SIG maillist - Distutils-SIG@python.org > https://mail.python.org/mailman/listinfo/distutils-sig > > ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
Re: [Distutils] Requesting PyPI classifiers for Sphinx
Bump. I'd like to request trove classifiers for the Sphinx like: "Topic :: Documentation :: Sphinx" "Topic :: Documentation :: Sphinx :: Extension" And additionally: "Topic :: Documentation :: Sphinx :: Theme" Thanks. On Thu Nov 20 2014 at 0:16:21 Takayuki Shimizukawa wrote: > Hi, > > I'd like to request classifiers for the Sphinx like: > > "Topic :: Documentation :: Sphinx" > "Topic :: Documentation :: Sphinx :: Extension" > > It would help us to search sphinx extensions and sphinx related tools. > .. ex. sphinx-intl, sphinx-testing, Tinkerer, and sphinx extensions. > .. refs: "[sphinx-users]: Survey of Sphinx extensions" [1]_ [2]_ > > Thanks. > > .. [1] https://groups.google.com/d/msg/sphinx-users/p82dKvqCUck/ > BBoavGgXRcwJ > .. [2] http://sphinxext-survey.readthedocs.org/en/latest/ > -- > Takayuki SHIMIZUKAWA > http://about.me/shimizukawa > ___ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig