Restructure oslotest docs

The bulk of the documentation was coming from README.rst, probably
too much, so I moved it to it's own file under docs.

Change-Id: Iec30feae9c152af7d8b6a1b79670b3f0149d2360

README.rst

@@ -2,33 +2,9 @@
  oslotest
 ==========
 
-OpenStack test framework and test fixtures
+OpenStack test framework and test fixtures.
 
 * Free software: Apache license
 * Documentation: http://docs.openstack.org/developer/oslotest
-
-Cross-testing With Other Projects
-=================================
-
-The oslotest package can be cross-tested against its consuming
-projects to ensure that no changes to the library break the tests in
-those other projects.
-
-In the Gate
------------
-
-Refer to the instructions in
-https://wiki.openstack.org/wiki/Oslo/UsingALibrary for setting up
-cross-test jobs in the gate.
-
-Locally
--------
-
-To run the cross-tests locally, invoke the script directly, passing
-the path to the other source repository and the tox environment name
-to use:
-
-::
-
-  $ cd oslo.test
-  $ ./tools/run_cross_tests.sh ~/repos/openstack/oslo.config py27
+* Source: http://git.openstack.org/cgit/openstack/oslotest
+* Bugs: http://bugs.launchpad.net/oslo

doc/source/index.rst

@@ -7,14 +7,17 @@
  Welcome to oslotest's documentation!
 ======================================
 
-Contents:
+OpenStack test framework and test fixtures.
+
+Contents
+========
 
 .. toctree::
    :maxdepth: 2
 
-   readme
    installation
    api
+   testing
    contributing
 
 Indices and tables

doc/source/readme.rst

@@ -1 +0,0 @@
-.. include:: ../../README.rst

doc/source/testing.rst

@@ -0,0 +1,30 @@
+=========
+ Testing
+=========
+
+Cross-testing With Other Projects
+=================================
+
+The oslotest package can be cross-tested against its consuming
+projects to ensure that no changes to the library break the tests in
+those other projects.
+
+In the Gate
+-----------
+
+Refer to the instructions in
+https://wiki.openstack.org/wiki/Oslo/UsingALibrary for setting up
+cross-test jobs in the gate.
+
+Locally
+-------
+
+To run the cross-tests locally, invoke the script directly, passing
+the path to the other source repository and the tox environment name
+to use:
+
+::
+
+  $ cd oslo.test
+  $ ./tools/run_cross_tests.sh ~/repos/openstack/oslo.config py27
+