User_stories and feature requests appended to sphinx

also some markup fixes to treat toctree look

Change-Id: Ibeac44a79e60dc6b2d82259a199856ad67c5fc36

doc/samples/deployments/devstack-lxc-engine-in-existing-servers.rst

@@ -1,5 +1,5 @@
-MultihostEngine
+Devstack-LXC-engine-in-dummy
-===============
+============================
 
 How to deploy cloud
 

doc/samples/deployments/multihost.rst

@@ -6,13 +6,13 @@ How to deploy multihost OpenStack
 MultihostEngine's configuration contains two sections: controller and nodes.
 
 Controller section
-==================
+------------------
 
 This section is full configuration of a deployment. Returned endpoints is
 endpoints of the whole cloud.
 
 Nodes section
-=============
+-------------
 
 This section is a list of full configurations of a compute nodes. Returned
 endpoints are silently ignored.

doc/samples/tasks/sla/README.rst

@@ -10,12 +10,12 @@ Currently supported criteria:
 
 
 max_failure_percent
-===================
+-------------------
 
 Maximum allowed failure rate in percent.
 
 
 max_seconds_per_iteration
-=========================
+-------------------------
 
 Maximum time in seconds per one iteration.

doc/source/conf.py

@@ -78,7 +78,8 @@ release = '0.0.1'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = []
+exclude_patterns = ['feature_request/README.rst', 'samples/README.rst',
+                    '**/README.rst']
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 #default_role = None

doc/source/feature_request

@@ -0,0 +1 @@
+../feature_request/

doc/source/feature_requests.rst

@@ -0,0 +1,6 @@
+.. include:: feature_request/README.rst
+
+.. toctree::
+   :glob:
+
+   feature_request/*

doc/source/index.rst

@@ -33,7 +33,7 @@ The OpenStack QA team mostly works on CI/CD that ensures that new patches don't
 Deeper in Rally:
 ----------------
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
    overview
    concepts
@@ -42,21 +42,16 @@ Deeper in Rally:
    verify
    installation
    usage
+   feature_requests
+   user_stories
 
 Development information:
 ------------------------
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
    cmds
    implementation
    improve_rally
    rally_gatejob
-
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`

doc/source/stories

@@ -0,0 +1 @@
+../user_stories

doc/source/user_stories.rst

@@ -0,0 +1,8 @@
+
+User stories:
+=============
+
+.. toctree::
+   :glob:
+
+   stories/**

doc/user_stories/keystone/authenticate.rst

@@ -1,6 +1,6 @@
-=========
+
-Benchmark
+Keystone token creation benchmark
-=========
+=================================
 Authenticate users with keystone to get tokens.
 
 Goal
@@ -45,10 +45,12 @@ Results
 
 1. Concurrency = 4
 
+.. code-block:: none
+
     {'context': {'users': {'concurrent': 30,
-                         | 'tenants': 12,
+                           'tenants': 12,
-                         | 'users_per_tenant': 512}},
+                           'users_per_tenant': 512}},
-                         | 'runner': {'concurrency': 4, 'times': 10000, 'type': 'constant'}}
+                           'runner': {'concurrency': 4, 'times': 10000, 'type': 'constant'}}
 
 
 +--------+-----------+-----------+-----------+---------------+---------------+---------+-------+-----------------------+--------------+
@@ -64,10 +66,12 @@ Results
 
 2. Concurrency = 16
 
+.. code-block:: none
+
     {'context': {'users': {'concurrent': 30,
-                         | 'tenants': 12,
+                           'tenants': 12,
-                         | 'users_per_tenant': 512}},
+                           'users_per_tenant': 512}},
-                         | 'runner': {'concurrency': 16, 'times': 10000, 'type': 'constant'}}
+                           'runner': {'concurrency': 16, 'times': 10000, 'type': 'constant'}}
 
 +--------+-----------+-----------+-----------+---------------+---------------+---------+-------+-----------------------+--------------+
 | action | min (sec) | avg (sec) | max (sec) | 90 percentile | 95 percentile | success | count |apache enabled keystone|public_workers|
@@ -82,10 +86,12 @@ Results
 
 3. Concurrency = 32
 
+.. code-block:: none
+
     {'context': {'users': {'concurrent': 30,
-                         | 'tenants': 12,
+                           'tenants': 12,
-                         | 'users_per_tenant': 512}},
+                           'users_per_tenant': 512}},
-                         | 'runner': {'concurrency': 32, 'times': 10000, 'type': 'constant'}}
+                           'runner': {'concurrency': 32, 'times': 10000, 'type': 'constant'}}
 
 +--------+-----------+-----------+-----------+---------------+---------------+---------+-------+-----------------------+--------------+
 | action | min (sec) | avg (sec) | max (sec) | 90 percentile | 95 percentile | success | count |apache enabled keystone|public_workers|