Docs: Reorganize usage docs to fit better into the new usage/developm…

…ent split
nextstrain · Jul 1, 2019 · 20ef4d4 · 20ef4d4
1 parent 825fb58
commit 20ef4d4
Show file tree

Hide file tree

Showing 4 changed files with 16 additions and 11 deletions.
diff --git a/docs/cli.rst b/docs/cli.rst
@@ -1,15 +1,12 @@
-===========
-Using Augur
-===========
+=============
+Augur command
+=============
 
 All of Augur's commands are accessed through the ``augur`` program.
 For example, to infer ancestral sequences from a tree, you'd run ``augur ancestral``.
 Each command is documented below.
 You can also run each command with the ``--help`` option, for example ``augur tree --help``, for more information at the command-line.
 
-Augur command
-=============
-
 .. argparse::
     :module: augur
     :func: make_parser

diff --git a/docs/examples.rst b/docs/examples.rst
@@ -1,6 +1,6 @@
-=======================
-Examples of using Augur
-=======================
+=============================
+Examples of Augur in the wild
+=============================
 
 We really enjoy hearing about people using Augur.  If you use Augur to do your
 work, we'd love to add it to this page!  Let us know about it by `opening an

diff --git a/docs/index.rst b/docs/index.rst
@@ -14,7 +14,6 @@ Augur originated as part of `Nextstrain <https://nextstrain.org>`__, an open-sou
    :caption: Table of contents
 
    installation
-   cli
+   usage
    api
-   examples
    authors
diff --git a/docs/usage.rst b/docs/usage.rst
@@ -0,0 +1,9 @@
+===========
+Using Augur
+===========
+
+.. toctree::
+   :maxdepth: 3
+
+   cli
+   examples