Updated content and structure of Sphinx docs

Author: emiliom

docs/source/contribute.rst

@@ -1,13 +1,13 @@
 Contributing
 ============================
 
-You can help with ODM2 Python API by contributing code, helping with the documentation, and engaging the team via GitHub issues (questions, solutions, etc).
+You can help with ODM2 Python API by contributing code, helping with the documentation, or engaging the team via `GitHub issues <https://github.com/ODM2/ODM2PythonAPI/issues>`_ (questions, solutions, etc).
 
 
-Installing the development version from the development branch on github
-----------------------------------
+Install the development version from GitHub
+--------------------------------------------
 
-Note: We follow the `Gitflow workflow <https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow>`__ for development.
+The latest development version is found in the ``development`` branch of the github repository. We follow the `Gitflow workflow <https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow>`__ for development.
 
 1. Download both ``requirements.txt`` and ``requirements-dev.txt``.
 

docs/source/getstarted.rst

@@ -2,8 +2,8 @@ Get Started
 ============
 
 
-Install the latest release as a conda package from conda-forge
-----------------------------------------------
+Install the latest release from a conda package
+------------------------------------------------
 
 conda
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

docs/source/index.rst

@@ -1,26 +1,24 @@
-ODM2 Python API
-===============
+ODM2 Python API (odm2api)
+=========================
 
-A Python-based application programmer's interface for the `Observations Data Model 2 (ODM2) <http://www.odm2.org>`__.
+A Python-based application programmer's interface for the `Observations Data Model 2 (ODM2) <http://www.odm2.org>`__. Development of ``odm2api`` is done at `<https://github.com/ODM2/ODM2PythonAPI/>`_.
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
    getstarted
-   modules
    odm2models
+   modules
    contribute
    credits
 
-Indices and tables
-==================
+Indices
+=======
 
 .. toctree::
    :maxdepth: 2
 
-   models
-
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`

docs/source/models.rst

@@ -12,7 +12,9 @@ The following are entities in the `ODM2 Core Schema <http://odm2.github.io/ODM2/
 
 .. autosummary::
 
+   odm2api.models.ActionBy
    odm2api.models.Actions
+   odm2api.models.Affiliations
    odm2api.models.DataSets
    odm2api.models.FeatureActions
    odm2api.models.Methods

docs/source/odm2models.rst

@@ -1,6 +1,39 @@
 ODM2 Models
 ===========
 
+ODM2 is organized with a "core" schema and multiple "extension" schemas that
+extend the functionality of the core. The following sections cover some overarching concepts
+for ODM2 and then focus on specific entities within the ODM2 Core schema and ODM2's extension schemas.
+
+ODM2Core Entities
+------------------
+
+The following are entities in the `ODM2 Core Schema <http://odm2.github.io/ODM2/schemas/ODM2_Current/diagrams/ODM2Core.html>`__:
+
+.. autosummary::
+
+   odm2api.models.ActionBy
+   odm2api.models.Actions
+   odm2api.models.Affiliations
+   odm2api.models.DataSets
+   odm2api.models.FeatureActions
+   odm2api.models.Methods
+   odm2api.models.Organizations
+   odm2api.models.People
+   odm2api.models.ProcessingLevels
+   odm2api.models.RelatedActions
+   odm2api.models.Results
+   odm2api.models.SamplingFeatures
+   odm2api.models.TaxonomicClassifiers
+   odm2api.models.Units
+   odm2api.models.Variables
+
+
+All ODM2 models
+----------------
+
+API descriptions for `all ODM2 models (entities) <http://odm2.github.io/ODM2/schemas/ODM2_Current/schemas/index.html>`_.
+
 .. automodule:: odm2api.models
    :members:
    :undoc-members: