From b9c59caaabff27b904b8efead95969d27562dc14 Mon Sep 17 00:00:00 2001
From: Sean McGinnis <sean.mcginnis@gmail.com>
Date: Mon, 1 Oct 2018 14:56:47 -0500
Subject: [PATCH] Update docs landing page to follow guideline

During the rocky cycle, there was a docs-spec approved [0] with the goal
of having a recommended consistent documentation landing page for all
projects.

This updates our docs landing page to follow the structure described in
that recommendation.

[0] http://specs.openstack.org/openstack/docs-specs/specs/rocky/front-page-template.html

Change-Id: I0f31c59e6b39ab8d9c0009f72967c793dadbed64
---
 doc/source/images/cinder.png | Bin 0 -> 5784 bytes
 doc/source/index.rst         | 166 ++++++++++++++++++++++-------------
 2 files changed, 106 insertions(+), 60 deletions(-)
 create mode 100644 doc/source/images/cinder.png

diff --git a/doc/source/images/cinder.png b/doc/source/images/cinder.png
new file mode 100644
index 0000000000000000000000000000000000000000..ccf18ae832938722664e9421325d495fe7a35a09
GIT binary patch
literal 5784
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
UyZ=J|Jvaddx~4i!T8^>*0}9{+i2wiq

literal 0
HcmV?d00001

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 28f602979aa..5dc8d510a0a 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -15,11 +15,20 @@
       License for the specific language governing permissions and limitations
       under the License.
 
-===========================================
-Cinder, the OpenStack Block Storage Service
-===========================================
+==============================================
+OpenStack Block Storage (Cinder) documentation
+==============================================
 
-Cinder is an OpenStack project to provide "block storage as a service".
+.. figure:: images/cinder.png
+   :alt: Cinder logo
+   :align: center
+
+What is Cinder?
+---------------
+
+Cinder is the OpenStack Block Storage service for providing volumes to Nova
+virtual machines, Ironic bare metal hosts, containers and more. Some of the
+goals of Cinder are to be/have:
 
 * **Component based architecture**: Quickly add new behaviors
 * **Highly available**: Scale to very serious workloads
@@ -27,89 +36,126 @@ Cinder is an OpenStack project to provide "block storage as a service".
 * **Recoverable**: Failures should be easy to diagnose, debug, and rectify
 * **Open Standards**: Be a reference implementation for a community-driven api
 
-This documentation is generated by the Sphinx toolkit and lives in the source
-tree. Additional draft and project documentation on Cinder and other components
-of OpenStack can be found on the `OpenStack wiki`_. Cloud administrators, refer
-to `docs.openstack.org`_.
+For end users
+-------------
 
-.. _`OpenStack wiki`: https://wiki.openstack.org/wiki/Main_Page
-.. _`docs.openstack.org`: https://docs.openstack.org
+As an end user of Cinder, you'll use Cinder to create and manage volumes using
+the Horizon user interface, command line tools such as the
+`python-cinderclient <https://docs.openstack.org/python-cinderclient/latest/>`_,
+or by directly using the
+`REST API <https://developer.openstack.org/api-ref/block-storage/>`_.
 
+Tools for using Cinder
+~~~~~~~~~~~~~~~~~~~~~~
 
-Installation Guide
-~~~~~~~~~~~~~~~~~~
+* `Horizon <https://docs.openstack.org/horizon/latest/user/manage-volumes.html>`_:
+  The official web UI for the OpenStack Project.
+* `OpenStack Client <https://docs.openstack.org/python-openstackclient/latest/>`_:
+  The official CLI for OpenStack Projects. You should use this as your CLI for
+  most things, it includes not just nova commands but also commands for most of
+  the projects in OpenStack.
+* `Cinder Client <https://docs.openstack.org/python-cinderclient/latest/user/shell.html>`_:
+  The **openstack** CLI is recommended, but there are some advanced features
+  and administrative commands that are not yet available there. For CLI access
+  to these commands, the **cinder** CLI can be used instead.
+
+Using the Cinder API
+~~~~~~~~~~~~~~~~~~~~
+
+All features of Cinder are exposed via a REST API that can be used to build
+more complicated logic or automation with Cinder. This can be consumed directly
+or via various SDKs. The following resources can help you get started consuming
+the API directly.
+
+* `Cinder API <https://developer.openstack.org/api-ref/block-storage/>`_
+* :doc:`Cinder microversion history </contributor/api_microversion_history>`
+
+For operators
+-------------
+
+This section has details for deploying and maintaining Cinder services.
+
+Installing Cinder
+~~~~~~~~~~~~~~~~~
+
+Cinder can be configured standalone using the configuration setting
+``auth_strategy = noauth``, but in most cases you will want to at least have
+the `Keystone <https://docs.openstack.org/keystone/latest/install/>`_ Identity
+service and other
+`OpenStack services <https://docs.openstack.org/latest/install/>`_ installed.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    Installation Guide <install/index>
    Upgrade Process <upgrade>
 
-Administration Guide
-~~~~~~~~~~~~~~~~~~~~
+Administrating Cinder
+~~~~~~~~~~~~~~~~~~~~~
+
+Contents:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    admin/index
 
-Configuration Reference
-~~~~~~~~~~~~~~~~~~~~~~~
+Reference
+~~~~~~~~~
+
+Contents:
 
 .. toctree::
-    :maxdepth: 2
-
-    configuration/index
-    reference/support-matrix
-    drivers
-
-CLI Reference
-~~~~~~~~~~~~~
-
-Information on the commands available through Cinder's Command Line
-Interface (CLI) can be found in this section of documentation.
-
-Full documentation on the python-cinderclient is in the
-`python-cinderclient documentation`_.
-
-.. _`python-cinderclient documentation`: https://docs.openstack.org/python-cinderclient/latest
-
-.. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
+   configuration/index
+   reference/support-matrix
+   drivers
    cli/index
 
-Contributor/Developer Docs
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Additional resources
+~~~~~~~~~~~~~~~~~~~~
+
+* `Cinder release notes <https://docs.openstack.org/releasenotes/cinder/>`_
+
+For contributors
+----------------
+
+Contributions to Cinder are welcome. There can be a lot of background
+information needed to get started. This section should help get you started.
+Please feel free to also ask any questions in the **#openstack-cinder** IRC
+channel.
+
+Getting started
+~~~~~~~~~~~~~~~
+
+* `OpenStack Contributor Guide <https://docs.openstack.org/contributors/>`_
+
+Contributing to Cinder
+~~~~~~~~~~~~~~~~~~~~~~
+
+Contents:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    contributor/index
+   API Microversions </contributor/api_microversion_dev/>
 
+Additional reference
+~~~~~~~~~~~~~~~~~~~~
 
-API Extensions
-~~~~~~~~~~~~~~
-
-Go to https://developer.openstack.org/api-ref/block-storage/ for information
-about Cinder API extensions.
-
-:doc:`Block Storage v3 API Microversion History </contributor/api_microversion_history>`:
-The block storage v3 API evolves over time through
-:doc:`API Microversions </contributor/api_microversion_dev/>`. This
-provides the history of all those changes. Consider it a "what's new" in the
-block storage v3 API.
-
-Indices and tables
-~~~~~~~~~~~~~~~~~~
-
-* :ref:`genindex`
-* :ref:`search`
-
-Glossary
-~~~~~~~~
+Contents:
 
 .. toctree::
    :maxdepth: 1
 
    common/glossary.rst
+
+Indices and tables
+~~~~~~~~~~~~~~~~~~
+
+Contents:
+
+* :ref:`genindex`
+* :ref:`search`