Rename and restructure install docs

The concept/name of controller was copied over from nova when the
docs were imported. That concept doesn't really fit in with
placement and also does not describe what the docs are actually
doing. We're not installing a controller, we're installing
placement.

Thus filenames and titles are updated and intro paragraphs
clarified.

Also, the endpoints.rst file is moved into a shared directory as it
is not a standalone install doc.

Note that the big warning remains on the top of the install docs
because it is still true. These instructions and the packages they
mention have not been verified.

Story: 2005190
Change-Id: I5fcbc90eda3ef74dba2336ea3e5c9f53938c6378

doc/source/index.rst

@@ -278,9 +278,9 @@ This history of placement microversions may be found in
    contributor/index
    install/index
    install/from-pypi
-   install/controller-install-obs
-   install/controller-install-rdo
-   install/controller-install-ubuntu
+   install/install-obs
+   install/install-rdo
+   install/install-ubuntu
    install/verify
    placement-api-microversion-history
    usage/index

doc/source/install/index.rst

@@ -22,8 +22,9 @@ placement with the rest of an OpenStack cloud.
 .. toctree::
    :maxdepth: 1
 
-   controller-install-obs.rst
-   controller-install-rdo.rst
-   controller-install-ubuntu.rst
+   from-pypi.rst
+   install-obs.rst
+   install-rdo.rst
+   install-ubuntu.rst
 
 .. _HTTP API: https://developer.openstack.org/api-ref/placement/

doc/source/install/install-obs.rst

@@ -1,8 +1,8 @@
-Install and configure controller node for openSUSE and SUSE Linux Enterprise
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Install and configure Placement for openSUSE and SUSE Linux Enterprise
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This section describes how to install and configure the placement service on
-the controller node.
+This section describes how to install and configure the placement service
+when using openSUSE or SUSE Linux Enterprise packages.
 
 Prerequisites
 -------------
@@ -44,7 +44,7 @@ Create Database
 Configure User and Endpoints
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. include:: endpoints.rst
+.. include:: shared/endpoints.rst
 
 Install and configure components
 --------------------------------

doc/source/install/install-rdo.rst

@@ -1,8 +1,8 @@
-Install and configure controller node for Red Hat Enterprise Linux and CentOS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Install and configure Placement for Red Hat Enterprise Linux and CentOS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This section describes how to install and configure the placement service on
-the controller node.
+This section describes how to install and configure the placement service
+when using Red Hat Enterprise Linux or CentOS packages.
 
 Prerequisites
 -------------
@@ -44,7 +44,7 @@ Create Database
 Configure User and Endpoints
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. include:: endpoints.rst
+.. include:: shared/endpoints.rst
 
 Install and configure components
 --------------------------------

doc/source/install/install-ubuntu.rst

@@ -1,8 +1,8 @@
-Install and configure controller node for Ubuntu
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Install and configure Placement for Ubuntu
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This section describes how to install and configure the placement service on
-the controller node.
+This section describes how to install and configure the placement service
+when using Ubuntu packages.
 
 Prerequisites
 -------------
@@ -44,7 +44,7 @@ Create Database
 Configure User and Endpoints
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. include:: endpoints.rst
+.. include:: shared/endpoints.rst
 
 Install and configure components
 --------------------------------