From cea0814cbe3a5e491cfa05af34a9eea40163dbf0 Mon Sep 17 00:00:00 2001 From: Doug Hellmann Date: Mon, 25 Aug 2014 12:03:48 -0400 Subject: [PATCH] Clean up docs before first release Add basic API documentation and release notes. Change-Id: I18fc06d23d8e46baf153a150e6af896c7bb67f04 --- README.rst | 8 ++++---- doc/source/api.rst | 9 +++++++++ doc/source/history.rst | 2 ++ doc/source/index.rst | 26 ++++++++++---------------- doc/source/usage.rst | 7 ------- 5 files changed, 25 insertions(+), 27 deletions(-) create mode 100644 doc/source/api.rst create mode 100644 doc/source/history.rst delete mode 100644 doc/source/usage.rst diff --git a/README.rst b/README.rst index dd6c7f7..d870cd8 100644 --- a/README.rst +++ b/README.rst @@ -1,10 +1,10 @@ -=================================== -oslo.serialization -=================================== +==================== + oslo.serialization +==================== oslo.serialization library * Free software: Apache license * Documentation: http://docs.openstack.org/developer/oslo.serialization * Source: http://git.openstack.org/cgit/openstack/oslo.serialization -* Bugs: http://bugs.launchpad.net/oslo \ No newline at end of file +* Bugs: http://bugs.launchpad.net/oslo diff --git a/doc/source/api.rst b/doc/source/api.rst new file mode 100644 index 0000000..da1af8e --- /dev/null +++ b/doc/source/api.rst @@ -0,0 +1,9 @@ +===== + API +===== + +jsonutils +========= + +.. automodule:: oslo.serialization.jsonutils + :members: diff --git a/doc/source/history.rst b/doc/source/history.rst new file mode 100644 index 0000000..db8340b --- /dev/null +++ b/doc/source/history.rst @@ -0,0 +1,2 @@ +.. include:: ../../ChangeLog + diff --git a/doc/source/index.rst b/doc/source/index.rst index 601e4e6..645fb74 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -1,24 +1,18 @@ -.. oslo.serialization documentation master file, created by - sphinx-quickstart on Tue Jul 9 22:26:36 2013. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. +==================== + oslo.serialization +==================== -Welcome to oslo.serialization's documentation! -=============================================================== +An OpenStack library for representing objects in transmittable and +storable formats. -Contents: +Contents +======== .. toctree:: - :maxdepth: 2 + :maxdepth: 1 readme installation - usage + api + history contributing - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` diff --git a/doc/source/usage.rst b/doc/source/usage.rst deleted file mode 100644 index aacca33..0000000 --- a/doc/source/usage.rst +++ /dev/null @@ -1,7 +0,0 @@ -======== -Usage -======== - -To use oslo.serialization in a project:: - - from oslo import serialization \ No newline at end of file