My understanding is that by hosting the docs at RTD, we'll be getting better search feature powered by Elasticsearch, instead of the built-in sphinx search.
If so, I would prefer this route.

Mariatta Wijaya

On Tue, Apr 11, 2017 at 12:11 PM, Brett Cannon <> wrote:

On Tue, 11 Apr 2017 at 11:28 Elvis Pranskevichus <> wrote:
On Tuesday, April 11, 2017 2:09:33 PM EDT Oleg Broytman wrote:
> On Tue, Apr 11, 2017 at 05:58:38PM +0000, Brett Cannon <> wrote:
> > On Tue, 11 Apr 2017 at 10:52 Elvis Pranskevichus <> wrote:
> > > On Tuesday, April 11, 2017 1:41:45 PM EDT Guido van Rossum wrote:
> > > > Last I heard from then, RTD was struggling financially. Hosting
> > > > isn't
> > > > really free, you know -- nor is administering a site like that
> > > > :-).
> > > > The PSF should offer to cover their costs for hosting the Python
> > > > docs, which I presume are pretty dang popular compared to many
> > > > other
> > > > things currently hosted at RTD -- the peps and devguide won't
> > > > cause
> > > > any load in comparison.
> > >
> > > Is Gihub Pages considered an option?  We host the asyncpg docs [1]
> > > there.  Builds are done by Travis.  The advantage is that we don't
> > > have to add another service dependency.
> >
> > I guess so. No one has ever suggested it before or bothered to set
> > it up to show how it would work. :)
>    GH Pages don't need much to setup. You have to choose between Org
> Pages (at the root of the subdomain) and Repo Pages (in
> subdirectories). I even believe GH Pages can do both on the same
> subdomain but I've never tried.

GH Pages support custom domain redirects [1].  "setup" in this case
is putting together scripts to automate sphinx runs and the git push
of the compiled output to the appropriate repo/branch.

So we would have to either set up another repo or commit the rendered files to the repo?
  If there's
interest in pursuing this option, I can help with setting things up.

I assume we would lose the widget Read the Docs provides which is handy for getting to the GitHub page for editing the content? I guess we lose anything else that lists.

I'm just trying to think of what we gain/lose if we switch to GH Pages over RTFD as I don't want to end up with three different documentation hosting solutions sort of like we have now where we build the devguide, PEPs, and the docs themselves in special ways that all happen to be hosted on PSF infrastructure (e.g. getting Pygments installed for the PEPs has stalled out and it would be good that any solution we choose be flexible enough to handle this kind of situation:

core-workflow mailing list
This list is governed by the PSF Code of Conduct: