Merge branch 'refactor-docstring-params-2' of https://github.com/echedey-ls/pvlib-python into refactor-docstring-params-2

Author: echedey-ls

pvlib/clearsky.py

@@ -705,7 +705,7 @@ def detect_clearsky(measured, clearsky, times=None, infer_limits=False,
         Time series of the expected clearsky GHI. [W/m2]
     times : DatetimeIndex or None, default None.
         Times of measured and clearsky values. If not specified, the index of
-        measured will be used.
+        ``measured`` will be used.
     infer_limits : bool, default False
         If True, does not use passed in kwargs (or defaults), but instead
         interpolates these values from Table 1 in [2]_.

pvlib/iotools/pvgis.py

@@ -410,10 +410,9 @@ def get_pvgis_tmy(latitude, longitude, outputformat='json', usehorizon=True,
     usehorizon : bool, default True
         include effects of horizon
     userhorizon : list of float, optional
-        optional user specified elevation of horizon in degrees, at equally
-        spaced azimuth clockwise from north, only valid if ``usehorizon`` is
-        true, if ``usehorizon`` is true but ``userhorizon`` is ``None`` then
-        PVGIS will calculate the horizon [3]_
+        Optional user-specified elevation of horizon in degrees, at equally
+        spaced azimuth clockwise from north. If not specified, PVGIS will
+        calculate the horizon [3]_. If specified, requires ``usehorizon=True``.
     startyear : int, optional
         first year to calculate TMY
     endyear : int, optional

pvlib/iotools/tmy.py

@@ -41,7 +41,7 @@ def read_tmy3(filename, coerce_year=None, map_variables=None, recolumn=None,
     filename : str
         A relative file path or absolute file path.
     coerce_year : int, optional
-        If supplied, the year of the index will be set to `coerce_year`, except
+        If supplied, the year of the index will be set to ``coerce_year``, except
         for the last index value which will be set to the *next* year so that
         the index increases monotonically.
     map_variables : bool, optional

pvlib/irradiance.py

@@ -575,7 +575,7 @@ def get_ground_diffuse(surface_tilt, ghi, albedo=.25, surface_type=None):
         overridden if surface_type is supplied.
 
     surface_type : string, optional
-        If not None, overrides albedo. String can be one of 'urban',
+        If supplied, overrides ``albedo``. String can be one of 'urban',
         'grass', 'fresh grass', 'snow', 'fresh snow', 'asphalt', 'concrete',
         'aluminum', 'copper', 'fresh steel', 'dirty steel', 'sea'.