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

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
