Reformat Scaling Journey content

Present each step in the journey, then move other content to a specific
subfolder.

Change-Id: I1f7c3347c212c64315b000511293090f0d48720e

doc/source/index.rst

@@ -5,12 +5,13 @@ Welcome to the documentation of the Large Scale SIG
 Contents:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    readme
    journey/index
-   contributor/index
    stories/index
+   other/index
+   contributor/index
 
 Indices and tables
 ==================

doc/source/journey/configure.rst

@@ -1,6 +1,6 @@
--------------------------
+------------------
-Large Scale SIG/Configure
+Stage 1: Configure
--------------------------
+------------------
 
 The first stage in the :doc:`Scaling Journey <../index>` is Configure.
 
@@ -29,7 +29,7 @@ A:
 
 Q: Which parameters should I adjust in RabbitMQ before tackling scale ?
 
-A: See :doc:`Large Scale Configuration of RabbitMQ <configure/rabbitmq>`
+A: See :doc:`Large Scale Configuration of RabbitMQ </other/rabbitmq>`
 
 Q: Should I use memcached?
 
@@ -37,13 +37,13 @@ A: Yes, it will help a lot keystone (memcached will be used to store tokens inst
 
 Q: Rabbitmq cluster seems hard to configure, what are the recommendations?
 
-A: See :doc:`Large Scale Configuration of RabbitMQ <configure/rabbitmq>`
+A: See :doc:`Large Scale Configuration of RabbitMQ </other/rabbitmq>`
 
 
 Resources
 ---------
 
-* :doc:`Large_Scale_Configuration_Guidelines <guidelines/configuration_guideline>`
+* :doc:`/other/configuration_guidelines`
 * Neutron backends performance comparison: https://thesaitech.wordpress.com/2019/02/15/a-comparative-study-of-openstack-networking-architectures/
 * Evaluation of performance before deployment
 
@@ -57,5 +57,5 @@ Other SIG work on that stage
 * Document better configuration defaults for large scale
   
   * Collect input at https://etherpad.opendev.org/p/large-scale-sig-documentation
-  * Curate content at :doc:`Large_Scale_Configuration_Guidelines <guidelines/configuration_guideline>`
+  * Curate content at :doc:`/other/configuration_guidelines`
   * Push to official doc, pointing back to the guidelines page

doc/source/journey/index.rst

@@ -2,18 +2,21 @@
  The Scaling Journey
 =====================
 
-Contents:
+OpenStack operators growing their OpenStack deployments go through various
+stages in their scaling journey. That path was successfully traveled by many
+before. The Large Scale SIG works to extract that knowledge and provide
+answers for those who come next.
+
+For each step the SIG will collect frequently-asked questions and answers,
+articles, presentations. When documentation or tools are missing, we help
+to produce them.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   ceph
    configure
-   configure/rabbitmq
-   guidelines/configuration_guideline
    monitor
    scale_up
    scale_out
    upgrade_and_maintain
 
-WIP: Transfer the content from https://wiki.openstack.org/wiki/Large_Scale_SIG

doc/source/journey/monitor.rst

@@ -1,6 +1,6 @@
-=======================
+================
-Large Scale SIG/Monitor
+Stage 2: Monitor
-=======================
+================
 
 The second stage in the :doc:`Scaling Journey <../index>` is Monitor.
 

doc/source/journey/scale_out.rst

@@ -1,6 +1,6 @@
-========================
+==================
-Large Scale SIG/ScaleOut
+Stage 4: Scale Out
-========================
+==================
 
 The fourth stage in the :doc:`Scaling Journey <../index>` is Scale Out.
 
@@ -64,4 +64,4 @@ A: Again it depends on your use case… For example some large infrastructures a
 
 Q: Who is running Cells and Regions?
 
-A: As an example, CERN deployment uses Cells and Regions.
+A: As an example, CERN deployment uses Cells and Regions.

doc/source/journey/scale_up.rst

@@ -1,6 +1,6 @@
-=======================
+=================
-Large Scale SIG/ScaleUp
+Stage 3: Scale Up
-=======================
+=================
 
 The third stage in the :doc:`Scaling Journey <../index>` is Scale Up.
 

doc/source/journey/upgrade_and_maintain.rst

@@ -1,6 +1,6 @@
-==================================
+=============================
-Large Scale SIG/UpgradeAndMaintain
+Stage 5: Upgrade And Maintain
-==================================
+=============================
 
 The final stage in the :doc:`Scaling Journey <../index>` is Upgrade and Maintain.
 

doc/source/other/configuration_guidelines.rst

@@ -1,6 +1,6 @@
-===================================
+====================================
-Large Scale Configuration Guideline
+Large Scale Configuration Guidelines
-===================================
+====================================
 
 Introduction
 ------------

doc/source/other/index.rst

@@ -0,0 +1,12 @@
+=================
+ Other resources
+=================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   configuration_guidelines
+   rabbitmq
+   ceph