Re: [Distutils] Requesting PyPI classifiers for Sphinx
Hi Fred, On Tue Nov 25 2014 at 23:12:14 Fred Drake f...@fdrake.net wrote: On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa shimizuk...@gmail.com 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 26, 2014 at 5:46 AM, Takayuki Shimizukawa shimizuk...@gmail.com wrote: How about this? Topic :: Documentation :: Sphinx Framework :: Sphinx Framework :: Sphinx :: Extension Framework :: Sphinx :: Theme +1 -Fred -- Fred L. Drake, Jr.fred at fdrake.net 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
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 Thu Nov 27 2014 at 9:08:40 AM Donaldo Fastoso donquest...@rocketmail.com 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
On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones rich...@python.org 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.fred at fdrake.net 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 shimizuk...@gmail.com wrote: Hi Fred, On Tue Nov 25 2014 at 23:12:14 Fred Drake f...@fdrake.net wrote: On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa shimizuk...@gmail.com 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
Thanks for that, Fred. I've added all four classifiers. Richard On Thu Nov 27 2014 at 9:26:24 AM Fred Drake f...@fdrake.net wrote: On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones rich...@python.org 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.fred at fdrake.net 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 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 rich...@python.org wrote: On Thu Nov 27 2014 at 9:26:24 AM Fred Drake f...@fdrake.net wrote: On Wed, Nov 26, 2014 at 5:15 PM, Richard Jones rich...@python.org 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.fred at fdrake.net 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 shimizuk...@gmail.com 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 shimizuk...@gmail.com 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
On Wed, Nov 19, 2014 at 10:16 AM, Takayuki Shimizukawa shimizuk...@gmail.com 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.fred at fdrake.net 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
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 shimizuk...@gmail.com 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] Requesting PyPI classifiers for Sphinx
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
