[Catalog-sig] readthedocs.org or packages.python.org?

[Richard Jones]

On 7 February 2013 08:00, Jesse Noller <jnoller at gmail.com> wrote:
> On Wednesday, February 6, 2013 at 3:57 PM, Lennart Regebro wrote:
>> So all-in-all, if we marget packages.p.o. and RTD somehow, then the
>> functionality of RTD must be enhanced, which may not be what the RTD
>> people want?
>
> I am sure I can talk to the maintainers (we're friends) and if anything, happily pay them for the support we need.

While expanding the scope of RTD seems like a good idea (pending
agreement by the maintainers) I wonder what it is that we're actually
achieving?

Currently with RTD and packages.python.org we've got two free,
easy-to-use services for hosting documentation.

I believe our goal should be to make it easier for projects to provide
documentation.

If RTD was made to accept setuptools* upload_docs pushes (implying
also that they host arbitrary content) then it could be a replacement
for packages.python.org eventually. There'd be some transition pain
though (especially if users of upload_docs didn't notice.)

Either way both are linked from PyPI, both are good Google juice, ...

I guess one of the benefits of merging is that the PSF only has one
such service to maintain - although to be honest the burden of
maintaining packages.python.org runs to about one support issue a year
- a pittance compared to PyPI :-)


    Richard

* yes, I keep forgetting to look into getting that into distutils core