From ecac38aa90c5d5d15dafe56bb9c0414c8c757e01 Mon Sep 17 00:00:00 2001 From: Doug Hellmann Date: Wed, 19 Nov 2014 12:05:17 -0500 Subject: Documentation cleanup Tidy up filenames, layout, and other minor issues with the documentation before our first release. bp/graduate-oslo-context Change-Id: Ib284bbdb50f868b232abc050311ddd5a9d9bde15 --- doc/source/api/autoindex.rst | 6 ------ doc/source/api/context.rst | 7 +++++++ doc/source/api/fixture.rst | 7 +++++++ doc/source/api/index.rst | 9 +++++++++ doc/source/api/oslo_context.context.rst | 7 ------- doc/source/api/oslo_context.fixture.rst | 7 ------- doc/source/api/oslo_context.tests.test_context.rst | 7 ------- doc/source/index.rst | 10 ++-------- doc/source/installation.rst | 5 ----- doc/source/readme.rst | 1 - doc/source/usage.rst | 2 +- 11 files changed, 26 insertions(+), 42 deletions(-) delete mode 100644 doc/source/api/autoindex.rst create mode 100644 doc/source/api/context.rst create mode 100644 doc/source/api/fixture.rst create mode 100644 doc/source/api/index.rst delete mode 100644 doc/source/api/oslo_context.context.rst delete mode 100644 doc/source/api/oslo_context.fixture.rst delete mode 100644 doc/source/api/oslo_context.tests.test_context.rst delete mode 100644 doc/source/readme.rst diff --git a/doc/source/api/autoindex.rst b/doc/source/api/autoindex.rst deleted file mode 100644 index 1d5d077..0000000 --- a/doc/source/api/autoindex.rst +++ /dev/null @@ -1,6 +0,0 @@ -.. toctree:: - :maxdepth: 1 - - oslo_context.context.rst - oslo_context.fixture.rst - oslo_context.tests.test_context.rst diff --git a/doc/source/api/context.rst b/doc/source/api/context.rst new file mode 100644 index 0000000..d9ddf35 --- /dev/null +++ b/doc/source/api/context.rst @@ -0,0 +1,7 @@ +The :mod:`oslo_context.context` Module +====================================== + +.. automodule:: oslo_context.context + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/fixture.rst b/doc/source/api/fixture.rst new file mode 100644 index 0000000..58ef47f --- /dev/null +++ b/doc/source/api/fixture.rst @@ -0,0 +1,7 @@ +The :mod:`oslo_context.fixture` Module +====================================== + +.. automodule:: oslo_context.fixture + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/index.rst b/doc/source/api/index.rst new file mode 100644 index 0000000..a123a00 --- /dev/null +++ b/doc/source/api/index.rst @@ -0,0 +1,9 @@ +================== + oslo.context API +================== + +.. toctree:: + :maxdepth: 1 + + context.rst + fixture.rst diff --git a/doc/source/api/oslo_context.context.rst b/doc/source/api/oslo_context.context.rst deleted file mode 100644 index d9ddf35..0000000 --- a/doc/source/api/oslo_context.context.rst +++ /dev/null @@ -1,7 +0,0 @@ -The :mod:`oslo_context.context` Module -====================================== - -.. automodule:: oslo_context.context - :members: - :undoc-members: - :show-inheritance: diff --git a/doc/source/api/oslo_context.fixture.rst b/doc/source/api/oslo_context.fixture.rst deleted file mode 100644 index 58ef47f..0000000 --- a/doc/source/api/oslo_context.fixture.rst +++ /dev/null @@ -1,7 +0,0 @@ -The :mod:`oslo_context.fixture` Module -====================================== - -.. automodule:: oslo_context.fixture - :members: - :undoc-members: - :show-inheritance: diff --git a/doc/source/api/oslo_context.tests.test_context.rst b/doc/source/api/oslo_context.tests.test_context.rst deleted file mode 100644 index 0c79f3f..0000000 --- a/doc/source/api/oslo_context.tests.test_context.rst +++ /dev/null @@ -1,7 +0,0 @@ -The :mod:`oslo_context.tests.test_context` Module -================================================= - -.. automodule:: oslo_context.tests.test_context - :members: - :undoc-members: - :show-inheritance: diff --git a/doc/source/index.rst b/doc/source/index.rst index 338de21..86b923f 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -1,16 +1,10 @@ -============== - oslo.context -============== - -Welcome to oslo.context's documentation! -======================================== +.. include:: ../../README.rst Contents: .. toctree:: :maxdepth: 2 - readme installation usage contributing @@ -22,7 +16,7 @@ Code Documentation .. toctree:: :maxdepth: 1 - api/autoindex + api/index Indices and tables ================== diff --git a/doc/source/installation.rst b/doc/source/installation.rst index d268650..0ee7ae1 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -5,8 +5,3 @@ Installation At the command line:: $ pip install oslo.context - -Or, if you have virtualenvwrapper installed:: - - $ mkvirtualenv oslo.context - $ pip install oslo.context \ No newline at end of file diff --git a/doc/source/readme.rst b/doc/source/readme.rst deleted file mode 100644 index a6210d3..0000000 --- a/doc/source/readme.rst +++ /dev/null @@ -1 +0,0 @@ -.. include:: ../../README.rst diff --git a/doc/source/usage.rst b/doc/source/usage.rst index 1118e9a..a1e9e92 100644 --- a/doc/source/usage.rst +++ b/doc/source/usage.rst @@ -4,4 +4,4 @@ To use oslo.context in a project:: - from oslo import context + from oslo_context import context -- cgit v1.2.1