Provisionally align docs with new layout

ansible · Oct 27, 2019 · 5b79fc6 · 5b79fc6
1 parent 0b36c50
commit 5b79fc6
Show file tree

Hide file tree

Showing 7 changed files with 30 additions and 11 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -1,6 +1,6 @@
-*******
-History
-*******
+*********
+Changelog
+*********
 
 Unreleased
 ==========

diff --git a/README.rst b/README.rst
@@ -1,6 +1,6 @@
-********
-Molecule
-********
+****************
+Ansible Molecule
+****************
 
 .. image:: https://badge.fury.io/py/molecule.svg
    :target: https://badge.fury.io/py/molecule
@@ -29,6 +29,9 @@ Molecule
    :target: LICENSE
    :alt: Repository License
 
+About Ansible Molecule
+======================
+
 Molecule is designed to aid in the development and testing of
 `Ansible`_ roles.
 

diff --git a/docs/examples.rst b/docs/examples.rst
@@ -1,6 +1,6 @@
-********
-Examples
-********
+*************************
+Common Molecule Use Cases
+*************************
 
 .. _docker-usage-example:
 

diff --git a/docs/getting-started.rst b/docs/getting-started.rst
@@ -4,6 +4,8 @@
 Getting Started Guide
 *********************
 
+If you're looking to move a little faster, see the :ref:`quick-start`.
+
 The following guide will step through an example of developing and testing a
 new Ansible role. After reading this guide, you should be familiar with the
 basics of how to use Molecule and what it can offer.

diff --git a/docs/quick-start.rst b/docs/quick-start.rst
@@ -0,0 +1,7 @@
+.. _quick-start:
+
+*****************
+Quick Start Guide
+*****************
+
+TODO.
diff --git a/docs/upgrade.rst b/docs/upgrade.rst
@@ -0,0 +1,7 @@
+.. _upgrade:
+
+*************
+Upgrade Guide
+*************
+
+TODO.
diff --git a/docs/usage.rst b/docs/usage.rst
@@ -1,5 +1,5 @@
-Usage
-=====
+Command Line Reference
+======================
 
 Check
 ^^^^^