[Python-checkins] devguide: Make the wording about the order of the docs stronger and re-arrange

brett.cannon python-checkins at python.org
Mon Jan 10 03:14:12 CET 2011


brett.cannon pushed 4c5802cc45d1 to devguide:

http://hg.python.org/devguide/rev/4c5802cc45d1
changeset:   71:4c5802cc45d1
user:        Brett Cannon <brett at python.org>
date:        Sun Jan 09 17:45:57 2011 -0800
summary:
  Make the wording about the order of the docs stronger and re-arrange
things to go from easier to harder within sub-bullets.

files:
  index.rst

diff --git a/index.rst b/index.rst
--- a/index.rst
+++ b/index.rst
@@ -23,10 +23,10 @@
 ------------
 
 People who wish to contribute to Python **must** read the following documents
-in their top-level order (sub-level documents can be read in any order). You
-can stop where you feel comfortable and begin contributing without reading and
-understanding all of these documents, but please do not skip around within the
-documentation.
+in the order provided.
+You can stop where you feel comfortable and begin contributing immediately
+without reading and understanding these documents all at once, but please do
+not skip around within the documentation.
 
 * :ref:`setup`
 * Coding style guides
@@ -35,11 +35,11 @@
 * :ref:`patch`
 * :ref:`runtests`
 * Beginner tasks to become familiar with the development process
+    * :ref:`docquality`
     * :ref:`coverage`
-    * :ref:`docquality`
 * Advanced tasks for once you are comfortable
+    * :ref:`silencewarnings`
     * Fixing issues found by the buildbots_
-    * :ref:`silencewarnings`
     * :ref:`fixingissues`
     * :ref:`triage`
 * :ref:`devrole`

--
Repository URL: http://hg.python.org/devguide


More information about the Python-checkins mailing list