launchpad-reviewers team mailing list archive

[Colin Watson <mp+427503@xxxxxxxxxxxxxxxxxx>]

Colin Watson has proposed merging ~cjwatson/launchpad:improve-how-to-structure into launchpad:master.

Commit message:
Improve how-to index structure

Requested reviews:
  Launchpad code reviewers (launchpad-reviewers)

For more details, see:
https://code.launchpad.net/~cjwatson/launchpad/+git/launchpad/+merge/427503

The how-to index page had grown to a bit of a wall of links, and is only likely to grow further.  Break it down into a few different logical sections.
-- 
Your team Launchpad code reviewers is requested to review the proposed merge of ~cjwatson/launchpad:improve-how-to-structure into launchpad:master.

diff --git a/doc/how-to/index.rst b/doc/how-to/index.rst
index 2324586..7fae5e5 100644
--- a/doc/how-to/index.rst
+++ b/doc/how-to/index.rst
@@ -3,20 +3,44 @@
 How-to Guides
 =============
 
+Getting started
+---------------
+
 .. toctree::
    :maxdepth: 1
 
    running
+
+Common development tasks
+------------------------
+
+.. toctree::
+   :maxdepth: 1
+
    exceptions
    security
-   new-user
    avoid-debugging-issues
+   preserve-query-count
+   land-update-for-loggerhead
+   update-configuration-for-testing
+   doc-theme
+
+Operating development instances
+-------------------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   new-user
    apply-schema-changes
    use-updated-dependency
+
+Operating Canonical's instances
+-------------------------------
+
+.. toctree::
+   :maxdepth: 1
+
    resurrect-dogfood
    restarting-services-on-dogfood
-   preserve-query-count
-   land-update-for-loggerhead
-   update-configuration-for-testing
    deploying-configuration-changes
-   doc-theme