Don't stop now.

docs/api_reference/index.rst

@@ -8,7 +8,6 @@ API Reference
 
 .. toctree::
    :maxdepth: 2
-   :caption: Contents:
 
    module_efficiency
    power_conversion

docs/index.rst

@@ -6,14 +6,21 @@ software components and functions created by PV Performance Labs.
 Many were developed in the context of consulting or research projects,
 sometimes as a necessity, and sometimes just to make life easier.
 
-The aim of this package is to make life easier for people facing similar needs and so, in
-a small way, contribute to the transition from fossil fuels
+The aim of this package is to make life easier for people facing similar needs
+and so, in a small way, contribute to the transition from fossil fuels
 to renewable sources--and solar energy in particular.
 
-``pvpltools`` is compatible with and complementary to
- `pvlib python <https://pvlib-python.readthedocs.io>`_.
+The current version of this package is found on github as
+`pvplabs/pvpltools
+<https://github.com/pvplabs/pvpltools>`.
+Prior to 2024, the code was published as
+`adriesse/pvpltools-python
+<https://github.com/adriesse/pvpltools-python>`_.
+This older repository will remain in place, but will not be updated.
 
-https://pvlib-python.readthedocs.io/en/stable/
+
+The package ``pvpltools`` is compatible with and complementary to
+`pvlib python <https://pvlib-python.readthedocs.io>`_.
 
 .. toctree::
    :maxdepth: 1

docs/user_guide/index.rst

@@ -4,6 +4,14 @@
 User Guide
 ==========
 
+Currently, there are four groups of functions related to the topics:
+
+- PV module efficiency: modeling efficiency as a function of irradiance and temperature
+- power conversion: efficiency losses in inverters, but not limited to inverters
+- energy rating: the (evolving) IEC-61853 method for rating PV modules
+- DataPlusMeta: read and write columnar data together with important metadata in a human-readable text file
+
+
 .. toctree::
    :maxdepth: 2