Build PEPs using Sphinx

[brettcannon]

Might make things easier to manage, style, etc.

[Carreau]

Does that have any impacts on https://www.python.org/dev/peps/* ?(which already renders the peps well)

[birkenfeld]

Indeed, since the main purpose is to be rendered on www.python.org I don't think this would change much. The added markup also isn't really used for PEPs.

[brettcannon]

So I envision this tying into #3 so that we can host things on Read the Docs and have a sub-domain for the PEPs.

[birkenfeld]

Making that match the design and style currently used on python.org would be tedious, though.

[Carreau]

So I envision this tying into #3 so that we can host things on Read the Docs and have a sub-domain for the PEPs.

So would that mean pepe would no longer be displayed on Python.org ?

Also from other project i'm contributing too, multiple domains for different section of a website are painful, (especially on readthedocs) because the navigation does not work well across site.

It would though most likely be feasible to build this on travis and cross-push on the python/pythondotorg repository to trigger a rebuild of the main website. Or of you don't like that, push a separate branch and auto submit a PR.

[brettcannon]

I don't care if the style changes. I just think having the PEPs buried in www.python.org and having such a separate build process is odd, especially when the contents have no direct connection to what's on www.python.org (who directly links to the PEPs from www.python.org anyway beyond navigation links?)

As for setting up some way to have pythondotorg automatically re-build the PEPs when a commit occurs, I'm quite happy to see that happen.

[Carreau]

I don't care if the style changes. I just think having the PEPs buried in www.python.org and having such a separate build process is odd, especially when the contents have no direct connection to what's on www.python.org (who directly links to the PEPs from www.python.org anyway beyond navigation links?)

As for setting up some way to have pythondotorg automatically re-build the PEPs when a commit occurs, I'm quite happy to see that happen.

Thanks, that's a much simpler problem if we have less backward compatibility.

[brettcannon]

I'm combining #3 with this issue as there's no point in making the PEPs build with Sphinx if we don't create a subdomain of peps.python.org that is hosted on Read the Docs.

[foonsun]

thanks for your effort