Sandro Tosi <sandro.t...@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 <rep...@bugs.python.org>
<http://bugs.python.org/issue12409>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to