Apply suggestions from code review

Co-authored-by: Echedey Luis <[email protected]>

Author: RDaxini

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

@@ -6,7 +6,8 @@ v0.11.2 (Anticipated December, 2024)
 
 Deprecations
 ~~~~~~~~~~~~
-* Deprecated terms `dni_clearsky` and `clearsky_dni`, replaced with `dni_clear`
+* Deprecated terms ``dni_clearsky`` and ``clearsky_dni``, replaced with ``dni_clear``.
+  Affected functions are :py:func:`~pvlib.irradiance.dirindex` and :py:func:`~pvlib.irradiance.dni`.
   (:issue:`2272`, :pull:`2274`)
 
 

pvlib/irradiance.py

@@ -3649,7 +3649,7 @@ def dni(ghi, dhi, zenith, dni_clear=None, clearsky_tolerance=1.1,
         Clearsky direct normal irradiance.
 
     clearsky_tolerance : float, default 1.1
-        If `dni_clear` is given this parameter can be used to allow a
+        If ``dni_clear`` is given this parameter can be used to allow a
         tolerance by how much the calculated DNI value can be greater than
         the clearsky value before it is identified as an unreasonable value.
 
@@ -3662,7 +3662,7 @@ def dni(ghi, dhi, zenith, dni_clear=None, clearsky_tolerance=1.1,
         'zenith_threshold_for_clearsky_limit' and smaller the
         'zenith_threshold_for_zero_dni' that are greater than the clearsky DNI
         (times allowed tolerance) will be corrected. Only applies if
-        `dni_clear` is not None.
+        ``dni_clear`` is not None.
 
     Returns
     -------