add initial api doc

Author: wholmgren

docs/sphinx/source/api.rst

@@ -0,0 +1,37 @@
+.. currentmodule:: pvlib
+
+#############
+API reference
+#############
+
+
+Classes
+=======
+
+pvlib-python provides a collection of classes
+for users that prefer object-oriented programming.
+These classes can help users keep track of data in a more organized way,
+and can help to simplify the modeling process.
+The classes do not add any functionality beyond the procedural code.
+Most of the object methods are simple wrappers around the
+corresponding procedural code.
+
+.. autosummary::
+   :toctree: generated/
+
+   pvlib.location.Location
+   pvlib.pvsystem.PVSystem
+   pvlib.tracking.SingleAxisTracker
+   pvlib.modelchain.ModelChain
+   pvlib.pvsystem.LocalizedPVSystem
+   pvlib.tracking.LocalizedSingleAxisTracker
+
+
+Solar Position
+==============
+
+.. autosummary::
+   :toctree: generated/
+
+   pvlib.location.Location.get_solarposition
+   pvlib.solarposition

docs/sphinx/source/index.rst

@@ -63,6 +63,8 @@ of:
 Specific released versions of pvlib-python can be cited using their
 `Zenodo DOI <https://zenodo.org/search?ln=en&p=pvlib&action_search=>`_.
 
+   modules
+   classes
 
 Contents
 ========
@@ -77,8 +79,7 @@ Contents
    timetimezones
    clearsky
    forecasts
-   modules
-   classes
+   api
    comparison_pvlib_matlab
    variables_style_rules