Merge remote-tracking branch 'upstream/main' into spectrum_reference

Author: RDaxini

docs/sphinx/source/user_guide/index.rst

@@ -1,21 +1,35 @@
+.. _user_guide:
+
 ==========
 User Guide
 ==========
 
+This user guide is an overview and explains some of the key features of pvlib.
 
 .. toctree::
+   :caption: Getting started
    :maxdepth: 2
-
+   
    package_overview
    installation
    introtutorial
+   
+.. toctree::
+   :caption: Modeling topics
+   :maxdepth: 2
+   
    pvsystem
    modelchain
    timetimezones
-   clearsky
    bifacial
+   clearsky
    weather_data
    model_comparison
    singlediode
+
+.. toctree::
+   :caption: Extras
+   :maxdepth: 2
+
    nomenclature
    faq

docs/sphinx/source/whatsnew/v0.11.3.rst

@@ -14,6 +14,7 @@ Enhancements
 
 Documentation
 ~~~~~~~~~~~~~
+* Restructure the user guide with subsections (:issue:`2302`, :pull:`2310`)
 
 
 Testing