Apply suggestions from code review

Co-authored-by: Kevin Anderson <[email protected]>

Author: RDaxini

docs/sphinx/source/user_guide/nomenclature.rst

@@ -142,9 +142,10 @@ There is a convention on consistent variable names throughout the library:
     solar_zenith
         Zenith angle of the sun in degrees
 
-    spectra, spectra_components
+    spectra
+    spectra_components
         Spectral irradiance (components) [Wm⁻²nm⁻¹]. The amount of energy
-        incident on a horizontal unit area per unit time and per unit
+        incident on a unit area per unit time and per unit
         wavelength. As with broadband irradiance, global spectral irradiance
         is composed of direct and diffuse components.
 

pvlib/spectrum/irradiance.py

@@ -190,7 +190,7 @@ def average_photon_energy(spectra):
     spectra : pandas.Series or pandas.DataFrame
 
         Spectral irradiance, must be positive [Wm⁻²nm⁻¹].
-        See :term:`spectra <spectra, spectra_components>`.
+        See :term:`spectra`.
 
         A single spectrum must be a :py:class:`pandas.Series` with wavelength
         [nm] as the index, while multiple spectra must be rows in a

pvlib/spectrum/spectrl2.py

@@ -232,7 +232,7 @@ def spectrl2(apparent_zenith, aoi, surface_tilt, ground_albedo,
         122, each array has shape (122, N) where N is the length of the
         input ``apparent_zenith``.  All values are spectral irradiance
         with units Wm⁻²nm⁻¹, except for `wavelength`, which is in nanometers.
-        See :term:`spectra_components <spectra, spectra_components>`.
+        See :term:`spectra_components`.
 
         * wavelength
         * dni_extra