doc: Create directory structure for docs migration

The spec [1] recommends the following sections:

- install
- contributor
- configuration
- cli
- admin
- user
- reference

Only a few of these are useful here:

- contributor
- cli
- user
- reference

Add these and populate them.

[1] specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration

Change-Id: I8a9ddcc915f25ebfaa1e994dba6c15883bd2715d

1 files changed, 9 insertions, 93 deletions

diff --git a/README.rst b/README.rst
index 0be65d77..00f86f46 100644
--- a/README.rst
+++ b/README.rst
@@ -7,8 +7,9 @@ Team and repository tags
 
 .. Change things from this point on
 
-Python bindings to the OpenStack Nova API
-=========================================
+============================================
+Python bindings to the OpenStack Compute API
+============================================
 
 .. image:: https://img.shields.io/pypi/v/python-novaclient.svg
     :target: https://pypi.python.org/pypi/python-novaclient/
@@ -18,23 +19,14 @@ Python bindings to the OpenStack Nova API
     :target: https://pypi.python.org/pypi/python-novaclient/
     :alt: Downloads
 
-This is a client for the OpenStack Nova API. There's a Python API (the
-``novaclient`` module), and a command-line script (``nova``). Each
-implements 100% of the OpenStack Nova API.
-
-See the `OpenStack CLI guide`_ for information on how to use the ``nova``
-command-line tool. You may also want to look at the
-`OpenStack API documentation`_.
-
-.. _OpenStack CLI Guide: http://docs.openstack.org/cli-reference/nova.html
-.. _OpenStack API documentation: http://developer.openstack.org/api-ref-compute-v2.1.html
-
-python-novaclient is licensed under the Apache License like the rest of
-OpenStack.
+This is a client for the OpenStack Compute API. It provides a Python API (the
+``novaclient`` module) and a command-line script (``nova``). Each implements
+100% of the OpenStack Compute API.
 
 * License: Apache License, Version 2.0
 * `PyPi`_ - package installation
 * `Online Documentation`_
+* `Launchpad project`_ - release management
 * `Blueprints`_ - feature specifications
 * `Bugs`_ - issue tracking
 * `Source`_
@@ -42,86 +34,10 @@ OpenStack.
 * `How to Contribute`_
 
 .. _PyPi: https://pypi.python.org/pypi/python-novaclient
-.. _Online Documentation: http://docs.openstack.org/developer/python-novaclient
+.. _Online Documentation: http://docs.openstack.org/python-novaclient
+.. _Launchpad project: https://launchpad.net/python-novaclient
 .. _Blueprints: https://blueprints.launchpad.net/python-novaclient
 .. _Bugs: https://bugs.launchpad.net/python-novaclient
 .. _Source: https://git.openstack.org/cgit/openstack/python-novaclient
 .. _How to Contribute: http://docs.openstack.org/infra/manual/developers.html
 .. _Specs: http://specs.openstack.org/openstack/nova-specs/
-
-
-.. contents:: Contents:
-   :local:
-
-Command-line API
-----------------
-
-Installing this package gets you a shell command, ``nova``, that you
-can use to interact with any OpenStack cloud.
-
-You'll need to provide your OpenStack username and password. You can do this
-with the ``--os-username``, ``--os-password`` and  ``--os-project-name``
-params, but it's easier to just set them as environment variables::
-
-    export OS_USERNAME=<username>
-    export OS_PASSWORD=<password>
-    export OS_PROJECT_NAME=<project-name>
-
-
-You will also need to define the authentication url with ``--os-auth-url``
-and the version of the API with ``--os-compute-api-version``.  Or set them as
-environment variables as well and set the OS_AUTH_URL to the keystone endpoint::
-
-    export OS_AUTH_URL=http://<url-to-openstack-keystone>:5000/v3/
-    export OS_COMPUTE_API_VERSION=2.1
-
-
-Since Keystone can return multiple regions in the Service Catalog, you
-can specify the one you want with ``--os-region-name`` (or
-``export OS_REGION_NAME``). It defaults to the first in the list returned.
-
-You'll find complete documentation on the shell by running
-``nova help``
-
-Python API
-----------
-
-There's also a complete Python API, with documentation linked below.
-
-
-To use with keystone as the authentication system::
-
-    >>> from keystoneauth1.identity import v3
-    >>> from keystoneauth1 import session
-    >>> from novaclient import client
-    >>> auth = v3.Password(auth_url='http://example.com:5000/v3',
-    ...                    username='username',
-    ...                    password='password',
-    ...                    project_name='project-name',
-    ...                    user_domain_id='default',
-    ...                    project_domain_id='default')
-    >>> sess = session.Session(auth=auth)
-    >>> nova = client.Client("2.1", session=sess)
-    >>> nova.flavors.list()
-    [...]
-    >>> nova.servers.list()
-    [...]
-    >>> nova.keypairs.list()
-    [...]
-
-
-Testing
--------
-
-There are multiple test targets that can be run to validate the code.
-
-* tox -e pep8 - style guidelines enforcement
-* tox -e py27 - traditional unit testing
-* tox -e functional - live functional testing against an existing
-  openstack
-
-Functional testing assumes the existence of a `clouds.yaml` file as supported
-by `os-client-config` (http://docs.openstack.org/developer/os-client-config)
-It assumes the existence of a cloud named `devstack` that behaves like a normal
-devstack installation with a demo and an admin user/tenant - or clouds named
-`functional_admin` and `functional_nonadmin`.