[Distutils] PyPI and Uploading Documentation

Wes Turner wes.turner at gmail.com
Sat May 16 12:33:18 CEST 2015

On May 16, 2015 4:55 AM, "Nick Coghlan" <ncoghlan at gmail.com> wrote:
> On 16 May 2015 at 04:34, Donald Stufft <donald at stufft.io> wrote:
> > So I can’t speak for ReadTheDocs, but I believe that they are
> > and/or are planning on offering arbitrary HTML uploads similarly to how
> > you can upload documentation to PyPI. I don’t know if this will actually
> > happen and what it would look like but I know they are thinking about
> I've never tried it with ReadTheDocs, but in theory the ".. raw::
> html" docutils directive allows arbitrary HTML content to be embedded
> in a reStructuredText page.
> Regardless, "Can ReadTheDocs do X?" questions are better asked on
> https://groups.google.com/forum/#!forum/

ReadTheDocs is hiring!


> while both
> GitHub and Atlassian (via BitBucket) offer free static HTML hosting.

I just wrote a tool (pypi:pgs) for serving files over HTTP directly from
gh-pages branches that works in conjunction with pypi:ghp-import (>
gh-pages; touch .nojekyll).

CloudFront DNS can sort of be used to add TLS/SSL to custom domains with
GitHub Pages (and probably BitBucket)

> In relation to the original question, +1 for attempting to phase out
> PyPI's documentation hosting capability in favour of delegating to
> RTFD or third party static HTML hosting. One possible option to
> explore that minimises disruption for existing users might be to stop
> offering it to *new* projects, while allowing existing projects to
> continue uploading new versions of their documentation.

- [ ] DOC: migration / alternatives guide

> Cheers,
> Nick.
> --
> Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> https://mail.python.org/mailman/listinfo/distutils-sig
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20150516/8ff25be2/attachment.html>

More information about the Distutils-SIG mailing list