[Python-Dev] Moving documentation of test.support into the devguide (original) (raw)
Eli Bendersky eliben at gmail.com
Fri Jul 29 09:51:27 CEST 2011
- Previous message: [Python-Dev] [Python-checkins] cpython: Issue #10639: reindent.py tool now accepts a --newline option to specify the
- Next message: [Python-Dev] cpython (3.2): Fix sorting or wording of some NEWS entries.
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
I've opened issue 12652 to track this task.
Proposed workflow:
- First, the devguide incorporates the documentation
- Then, I'll clean up the official docs and add pointers to the devguide instead
The transition of the documentation into the devguide also has a few steps:
- Move the reference of the utilities test.support provides. This reference documentation isn't complete (not all functions are documented), but can be completed later in the devguide.
- (Optionally) incorporate the test-writing advice given in 25.5.1 into the devguide (which currently has only a short couple of paragraphs
- Move any other information from the official docs (chapter 25) into the devguide, leaving only a section on running the tests (which should be identical to the relevant section in the devguide) and a pointer to the devguide.
Issue #12652 now has a patch for step (1) above.
Eli -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.python.org/pipermail/python-dev/attachments/20110729/fa359c26/attachment.html>
- Previous message: [Python-Dev] [Python-checkins] cpython: Issue #10639: reindent.py tool now accepts a --newline option to specify the
- Next message: [Python-Dev] cpython (3.2): Fix sorting or wording of some NEWS entries.
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]