This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients brett.cannon, docs@python, eric.araujo, ezio.melotti, fdrake, georg.brandl, rhettinger, sandro.tosi
Date 2011-07-02.12:49:00
SpamBayes Score 4.9939667e-06
Marked as misclassified No
Message-id <1309610941.25.0.0533545929005.issue12409@psf.upfronthosting.co.za>
In-reply-to
Content
I don’t understand Fred’s replies.

> The scope of this document is much larger than Python's documentation,
> but extends to all projects written in Python that use Sphinx as their
> documentation tool.
Really?  docs.python.org/documenting is much smaller that sphinx.pocoo.org, and only seems to cover documenting Python, not any Python project.

> With that, it makes sense to keep it as part of the documentation for
> users of Python.
I don’t follow.  You’re saying that since the document also covers other projects than Python, it makes sense to include it in the Python docs?

IMO, the criterion for the devguide is to have version-independent documents in one place instead of needlessly including them with CPython and having to sync across versions.  For the Documenting Python docs, if they contain version-specific instructions, or if they contain instructions needed in a CPython tarball, then they’re in the right place, otherwise they could move to the devguide.
History
Date User Action Args
2011-07-02 12:49:01eric.araujosetrecipients: + eric.araujo, fdrake, brett.cannon, georg.brandl, rhettinger, ezio.melotti, sandro.tosi, docs@python
2011-07-02 12:49:01eric.araujosetmessageid: <1309610941.25.0.0533545929005.issue12409@psf.upfronthosting.co.za>
2011-07-02 12:49:00eric.araujolinkissue12409 messages
2011-07-02 12:49:00eric.araujocreate