rework index page

Author: wholmgren

docs/sphinx/source/index.rst

@@ -1,67 +1,77 @@
-Welcome to pvlib-python's documentation!
+pvlib-python
 ========================================
 
-pvlib-python provides a set of documented functions for simulating 
-the performance of photovoltaic energy systems. 
-The toolbox was originally developed in MATLAB at 
-Sandia National Laboratories and it implements many of the 
-models and methods developed at the Labs. 
-More information on Sandia Labs PV performance modeling programs 
-can be found at https://pvpmc.sandia.gov/.
-
-The source code for pvlib-python is hosted on 
-`github <https://github.com/pvlib/pvlib-python>`_.
-
-The github page also contains a valuable
-`wiki <https://github.com/pvlib/pvlib-python/wiki>`_
-with information on how you can contribute to pvlib-python development!
-
-Please see the links above for details on the status of the pvlib-python
-project. We are at an early stage in the development of this project,
-so expect to see significant API changes in the next few releases.
-
-This documentation focuses on providing a reference for all of 
-the modules and functions available in pvlib-python.
-For examples of how to use pvlib-python, please see the
-`tutorials <http://nbviewer.ipython.org/github/pvlib/pvlib-python/tree/master/docs/tutorials/>`_.
-Some of the tutorials were written with older
-versions of pvlib-python and we would greatly appreciate your
-help updating them!
-
-.. note::
-
-   This documentation assumes general familiarity with
-   Python, NumPy, and Pandas. Google searches will yield many
-   excellent tutorials for these packages. 
-   
-Please see our 
-`PVSC 2014 paper <http://energy.sandia.gov/wp/wp-content/gallery/uploads/PV_LIB_Python_final_SAND2014-18444C.pdf>`_
-and
-`PVSC 2015 paper <https://github.com/pvlib/pvsc2015/blob/master/pvlib_pvsc_42.pdf>`_ 
-(and the `notebook to reproduce the figures <http://nbviewer.ipython.org/github/pvlib/pvsc2015/blob/master/paper.ipynb>`_) for more information.
-
-The GitHub wiki also has a page on `Projects and publications that use pvlib python <https://github.com/pvlib/pvlib-python/wiki/Projects-and-publications-that-use-pvlib-python>`_ for inspiration and listing of your application.
-
-There is a :ref:`variable naming convention <variables_style_rules>` to ensure consistency throughout the library.
-
-Installation
-============
-
-1. Follow Pandas' 
-   `instructions <http://pandas.pydata.org/pandas-docs/stable/install.html>`_
-   for installing the scientific python stack, including ``pip``.
-#. ``pip install pvlib-python``
+pvlib-python provides a set of documented functions for simulating the
+performance of photovoltaic energy systems. The toolbox was originally
+developed in MATLAB at Sandia National Laboratories and it implements
+many of the models and methods developed at the Labs. More information
+on Sandia Labs PV performance modeling programs can be found at
+https://pvpmc.sandia.gov/.
+
+The source code for pvlib-python is hosted on `github
+<https://github.com/pvlib/pvlib-python>`_.
+
+Please see the :ref:`installation` page for installation help.
+
+For examples of how to use pvlib-python, please see
+:ref:`package_overview` and our `Jupyter Notebook tutorials
+<http://nbviewer.ipython.org/github/pvlib/pvlib-python/tree/master/docs/
+tutorials/>`_. The documentation assumes general familiarity with
+Python, NumPy, and Pandas. Google searches will yield many
+excellent tutorials for these packages.
+
+The pvlib-python GitHub wiki has a `Projects and publications that use
+pvlib python
+<https://github.com/pvlib/pvlib-python/wiki/Projects-and-publications-
+that-use-pvlib-python>`_ page for inspiration and listing of your
+application.
+
+There is a :ref:`variable naming convention <variables_style_rules>` to
+ensure consistency throughout the library.
+
+Citing pvlib-python
+===================
+
+Many of the contributors to pvlib-python work in institutions where
+citation metrics are used in performance or career evaluations. If you
+use pvlib-python in a published work, please cite the most appropriate
+of:
+
+* J. S. Stein, “The photovoltaic performance modeling
+  collaborative (PVPMC),” in Photovoltaic Specialists Conference, 2012.
+* R.W. Andrews, J.S. Stein, C. Hansen, and D. Riley, “Introduction
+  to the open source pvlib for python photovoltaic system
+  modelling package,” in 40th IEEE Photovoltaic Specialist
+  Conference, 2014.
+  (`paper
+  <http://energy.sandia.gov/wp/wp-content/gallery/uploads/PV_LIB_Python_final_SAND2014-18444C.pdf>`_)
+* W.F. Holmgren, R.W. Andrews, A.T. Lorenzo, and J.S. Stein,
+  “PVLIB Python 2015,” in 42nd Photovoltaic Specialists Conference, 2015.
+  (`paper
+  <https://github.com/pvlib/pvsc2015/blob/master/pvlib_pvsc_42.pdf>`_ and
+  the `notebook to reproduce the figures
+  <http://nbviewer.ipython.org/github/pvlib/pvsc2015/blob/master/paper.ipynb>`_)
+* J.S. Stein, W.F. Holmgren, J. Forbess, and C.W. Hansen,
+  "PVLIB: Open Source Photovoltaic Performance Modeling Functions
+  for Matlab and Python," in 43rd Photovoltaic Specialists Conference, 2016.
+* W.F. Holmgren and D.G. Groenendyk,
+  "An Open Source Solar Power Forecasting Tool Using PVLIB-Python,"
+  in 43rd Photovoltaic Specialists Conference, 2016.
+
+Specific released versions of pvlib-python can be cited using their
+`Zenodo DOI <https://zenodo.org/search?ln=en&p=pvlib&action_search=>`_.
 
 
 Contents
 ========
 
 .. toctree::
    :maxdepth: 2
-   
-   self
+
    package_overview
    whatsnew
+   installation
+   contributing
    modules
    classes
    comparison_pvlib_matlab
@@ -72,6 +82,4 @@ Indices and tables
 ==================
 
 * :ref:`genindex`
-* :ref:`modindex`
 * :ref:`search`
-