Update remaining API documentation to use autodoc.

Author: anthony-tuininga

doc/README.md

@@ -1,34 +1,41 @@
-Sphinx is used to generate the HTML for the python-oracledb documentation.
+# python-oracledb Documentation Source
 
-The generated python-oracledb documentation is at
-https://python-oracledb.readthedocs.io/
+This directory contains the python-oracledb documentation source. It is written
+using reST (re-Structured Text). The source files are processed using
+[Sphinx](http://www.sphinx-doc.org) and can be turned into HTML, PDF or ePub
+documentation.
 
-This directory contains the documentation source.  It is written using reST
-(re-Structured Text). The source files are processed using Sphinx and can be
-turned into HTML, PDF or ePub documentation.
+**Visit https://python-oracledb.readthedocs.io/ for pre-built production and
+development python-oracledb documentation**
 
-If you wish to build documentation yourself, install Sphinx and the Read the
-Docs theme.  Sphinx is available on many Linux distributions as a pre-built
-package. You can also install Sphinx and the Read the Docs theme using the
-Python package manager "pip", for example::
+## Building Documentation Locally
 
-    python -m pip install -r requirements.txt
+To build the documentation locally:
 
-For more information on Sphinx, please visit this page:
+1. Install Sphinx and the Read the Docs theme using the Python package manager
+   ``pip``, for example:
 
-http://www.sphinx-doc.org
+        python -m pip install -r requirements.txt
 
-Once Sphinx is installed, the supplied Makefile can be used to build the
-different targets, for example to build the HTML documentation, run::
+   You can alternatively install these from pre-built packages for your
+   operating system.
 
-    make
+2. The "oracledb" module must be built and importable. This is needed for the
+   "autodoc" extension to create function signature documentation.
 
-To make ePub documentation, run::
+3. Once Sphinx is installed, and "oracledb" can be imported by Python, use the
+   Makefile to build your desired documentation format.
 
-    make epub
+   To build the HTML documentation:
 
-To make PDF documentation, run::
+       make
 
-    make pdf
+   To make ePub documentation:
 
-The program ``latexmk`` may be required by Sphinx to generate PDF output.
+       make epub
+
+   To make PDF documentation:
+
+       make pdf
+
+   The program ``latexmk`` may be required by Sphinx to generate PDF output.