summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDoug Hellmann <doug@doughellmann.com>2014-08-25 12:03:48 -0400
committerDoug Hellmann <doug@doughellmann.com>2014-08-25 12:03:48 -0400
commitcea0814cbe3a5e491cfa05af34a9eea40163dbf0 (patch)
treec49b943a59fdec9ee67ec14987e62546ecda69de
parent025c004c26cd9bf29a867de30b1591abceb85b90 (diff)
downloadoslo-serialization-cea0814cbe3a5e491cfa05af34a9eea40163dbf0.tar.gz
Clean up docs before first release
Add basic API documentation and release notes. Change-Id: I18fc06d23d8e46baf153a150e6af896c7bb67f04
-rw-r--r--README.rst8
-rw-r--r--doc/source/api.rst9
-rw-r--r--doc/source/history.rst2
-rw-r--r--doc/source/index.rst26
-rw-r--r--doc/source/usage.rst7
5 files changed, 25 insertions, 27 deletions
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