diff --git a/README.md b/README.md
index 7a7d94500f..c80f1c7acf 100644
--- a/README.md
+++ b/README.md
@@ -7,11 +7,11 @@
-
-
+
+
-
-
+
+
@@ -50,19 +50,8 @@
-
-
-
-
-
-
- Downloads |
-
-
-
-
-
-
+
+
|
@@ -99,17 +88,32 @@ The long-term success of pvlib-python requires substantial community support.
Citing
======
-If you use pvlib-python in a published work, please cite:
+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:
- William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski.
+**Recommended citation for the pvlib python project**
+
+ Anderson, K., Hansen, C., Holmgren, W., Jensen, A., Mikofski, M., and Driesse, A.
+ "pvlib python: 2023 project update."
+ Journal of Open Source Software, 8(92), 5994, (2023).
+ https://doi.org/10.21105/joss.05994
+
+
+**Recommended citation for pvlib iotools**
+
+ Jensen, A., Anderson, K., Holmgren, W., Mikofski, M., Hansen, C., Boeman, L., Loonen, R.
+ "pvlib iotools —- Open-source Python functions for seamless access to solar irradiance data."
+ Solar Energy, 266, 112092, (2023).
+ https://doi.org/10.1016/j.solener.2023.112092
+
+**Historical citation for pvlib python**
+
+ Holmgren, W., Hansen, C., and Mikofski, M.
"pvlib python: a python package for modeling solar energy systems."
Journal of Open Source Software, 3(29), 884, (2018).
https://doi.org/10.21105/joss.00884
-Please also cite the DOI corresponding to the specific version of
-pvlib-python that you used. pvlib-python DOIs are listed at
-[Zenodo.org](https://zenodo.org/search?page=1&size=20&q=conceptrecid:593284&all_versions&sort=-version)
-
If you use pvlib-python in a commercial or publicly-available application, please
consider displaying one of the "powered by pvlib" logos:
@@ -142,10 +146,10 @@ History and acknowledgement
===========================
pvlib python started out as a Python translation of the PVLIB MATLAB
-toolbox (developed by the `PVPMC `_ at
+toolbox (developed by the [PVPMC](https://pvpmc.sandia.gov/) at
Sandia National Laboratories) in 2013 and has grown substantially since then.
Today it contains code contributions from over a hundred individuals worldwide
-and is maintained by a core group of PV modelers from a variety institutions.
+and is maintained by a core group of PV modelers from a variety of institutions.
pvlib has been supported directly and indirectly by DOE, NumFOCUS, and
Google Summer of Code funding, university research projects,
diff --git a/docs/sphinx/source/index.rst b/docs/sphinx/source/index.rst
index d8d8d9debd..8e5773d639 100644
--- a/docs/sphinx/source/index.rst
+++ b/docs/sphinx/source/index.rst
@@ -48,28 +48,37 @@ companies that allow their employees to contribute, and from personal time.
Citing pvlib python
===================
-Many of the contributors to pvlib-python work in institutions where
+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:
- William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski.
+**Recommended citation for the pvlib python project**
+
+ Anderson, K., Hansen, C., Holmgren, W., Jensen, A., Mikofski, M., and Driesse, A.
+ "pvlib python: 2023 project update."
+ Journal of Open Source Software, 8(92), 5994, (2023).
+ https://doi.org/10.21105/joss.05994
+
+
+**Recommended citation for pvlib iotools**
+
+ Jensen, A., Anderson, K., Holmgren, W., Mikofski, M., Hansen, C., Boeman, L., Loonen, R.
+ "pvlib iotools — Open-source Python functions for seamless access to solar irradiance data."
+ Solar Energy, 266, 112092, (2023).
+ https://doi.org/10.1016/j.solener.2023.112092
+
+**Historical citation for pvlib python**
+
+ Holmgren, W., Hansen, C., and Mikofski, M.
"pvlib python: a python package for modeling solar energy systems."
Journal of Open Source Software, 3(29), 884, (2018).
https://doi.org/10.21105/joss.00884
+**Version specific citation**
Please also cite the DOI corresponding to the specific version of
pvlib python that you used. pvlib python DOIs are listed at
`Zenodo.org `_
-If you use pvlib-python in a commercial or publicly-available
-application, please consider displaying one of the "powered by pvlib"
-logos:
-
-.. image:: _images/pvlib_powered_logo_horiz.png
- :width: 300
-
-.. image:: _images/pvlib_powered_logo_vert.png
- :width: 300
Additional pvlib python publications include:
@@ -94,6 +103,19 @@ Additional pvlib python publications include:
"An Open Source Solar Power Forecasting Tool Using PVLIB-Python,"
in 43rd Photovoltaic Specialists Conference, 2016.
+
+Logo
+====
+If you use pvlib python in a commercial or publicly-available
+application, please consider displaying one of the "powered by pvlib"
+logos:
+
+.. image:: _images/pvlib_powered_logo_horiz.png
+ :width: 300
+
+.. image:: _images/pvlib_powered_logo_vert.png
+ :width: 300
+
License
=======
@@ -108,21 +130,12 @@ pvlib python is a `NumFOCUS Affiliated Project