Apply suggestions from code review

Co-authored-by: Cliff Hansen <cwhanse@sandia.gov>

Author: cbcrespo

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

@@ -18,8 +18,7 @@ Bug fixes
 
 Enhancements
 ~~~~~~~~~~~~
-* Add support for diffuse irradiance components to :py:func:`pvlib.irradiance.isotropic`
-  when ``return_components=True``. (:issue:`2750`, :pull:`2787`)
+* Add ``return_components`` kwarg to :py:func:`pvlib.irradiance.isotropic`. (:issue:`2750`, :pull:`2787`)
 * Ensure all timezones are available in all OSs. (:issue:`2795`, :pull:`2809`)
 
 

pvlib/irradiance.py

@@ -626,7 +626,7 @@ def isotropic(surface_tilt, dhi, return_components=False):
     return_components : bool, default ``False``
         If ``False``, ``sky_diffuse`` is returned.
         If ``True``, ``diffuse_components`` is returned.
-        For this model, `` return_components`` does not add more information,
+        For this model, `` return_components`` contains the same data as ``sky_diffuse``,
         but it is included for consistency with the other sky diffuse models.
 
     Returns
@@ -641,8 +641,8 @@ def isotropic(surface_tilt, dhi, return_components=False):
 
     diffuse_components : dict (array input) or DataFrame (Series input)
         Keys/columns are:
-            * poa_sky_diffuse: Total sky diffuse
-            * poa_isotropic
+            * poa_sky_diffuse: Total sky diffuse on the plane of array. [Wm⁻²]
+            * poa_isotropic: The portion of POA irradiance from the isotropic sky dome. [Wm⁻²]
 
     References
     ----------