[Distutils] PyPI and Uploading Documentation

[Wes Turner]

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
considering
> > 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
it.
>
> 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/
<https://groups.google.com/forum/#!forum/read-the-docs>read-the-docs
<https://groups.google.com/forum/#!forum/read-the-docs>,

ReadTheDocs is hiring!

https://blog.readthedocs.com/read-the-docs-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>