[docs] [issue12409] Moving "Documenting Python" to Devguide

Sandro Tosi report at bugs.python.org
Tue Aug 23 00:05:06 CEST 2011

Sandro Tosi <sandro.tosi at gmail.com> added the comment:

@Fred: thanks about it :)

@Éric: I just want to have clear in mind what you mean; my original proposal was to move completely, the whole section "Documenting python" to devguide since it contains building instructions and how's the markup works for python. Is your proposal different and so, as I can read, to just move the building part to devguide and the rest of it be left in python documentation with links to sphinx upstream documentation?

But one aspect I think it needs to be done as a prerequisite to this migration is: standardizing the sphinx/tools versions used to build the doc.

devguide is version-agnostic, so we can talk about (without convoluted sentences) only about one way to build the doc.

This was raised several times, even recently, on python-dev so I'm going to resurrect that thread so we can discuss there the pros/cons and then see from the outcome how we can move forward.

stage:  -> needs patch

Python tracker <report at bugs.python.org>

More information about the docs mailing list