docs: comments update

Author: JoLo90

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

@@ -10,7 +10,7 @@ Breaking Changes
 
 Deprecations
 ~~~~~~~~~~~~
-* ``Location.pytz`` is deprecated. Use ``Location.tz`` instead.
+* :py:attr:`pvlib.location.Location.pytz` is deprecated and will be removed in a future release. Use :py:attr:`~pvlib.location.Location.tz` instead.
   (:issue:`2343`, :pull:`2757`)
 
 

pvlib/location.py

@@ -43,11 +43,11 @@ class Location:
 
     tz : time zone as str, int, float, or datetime.tzinfo, default 'UTC'.
         See http://en.wikipedia.org/wiki/List_of_tz_database_time_zones for a
-        list of valid name strings. An `int` or `float` must be a whole-number
-        hour offsets from UTC that can be converted to the IANA-supported
-        'Etc/GMT-N' format. (Note the limited range of the offset N and its
-        sign-change convention.) Time zones from the zoneinfo packages may also
-        be passed here.
+        list of valid name strings. An ``int`` or ``float`` must be a
+        whole-number hour offsets from UTC that can be converted to the
+        IANA-supported 'Etc/GMT-N' format. (Note the limited range of the
+        offset N and its sign-change convention.) Time zones from the
+        ``zoneinfo`` packages may also be passed.
 
         The `tz` attribute is represented as a valid IANA time zone name
         string.

pvlib/solarposition.py

@@ -1360,7 +1360,7 @@ def hour_angle(times, longitude, equation_of_time):
         Corresponding timestamps, must be localized to the timezone for the
         ``longitude``.
 
-        ``AmbiguousTimeError`` in older pandas, ``ValueError`` in newer
+        ``AmbiguousTimeError`` in ``pandas<3``, ``ValueError`` in ``pandas>=3``
         will be raised if any of the given times are on a day when the local
         daylight savings transition happens at midnight.  If you're working
         with such a timezone, consider converting to a non-DST timezone