diff --git a/pvlib/irradiance.py b/pvlib/irradiance.py
index f1cc128724..c5c3b1c095 100644
--- a/pvlib/irradiance.py
+++ b/pvlib/irradiance.py
@@ -795,6 +795,12 @@ def haydavies(surface_tilt, surface_azimuth, dhi, dni, dni_extra,
     sky_diffuse : numeric
         The sky diffuse component of the solar radiation.
 
+    Notes
+    ------
+    When supplying ``projection_ratio``, consider constraining its values
+    when zenith angle approaches 90 degrees or angle of incidence
+    projection is negative. See code for details.
+
     References
     -----------
     .. [1] Loutzenhiser P.G. et. al. "Empirical validation of models to
diff --git a/pvlib/location.py b/pvlib/location.py
index 97767a5801..104fccac89 100644
--- a/pvlib/location.py
+++ b/pvlib/location.py
@@ -183,7 +183,7 @@ def get_solarposition(self, times, pressure=None, temperature=12,
         -------
         solar_position : DataFrame
             Columns depend on the ``method`` kwarg, but always include
-            ``zenith`` and ``azimuth``.
+            ``zenith`` and ``azimuth``. The angles are in degrees.
         """
         if pressure is None:
             pressure = atmosphere.alt2pres(self.altitude)