diff --git a/docs/assets/polished.js b/docs/assets/polished.js
index 1ff377c9..12fb064c 100644
--- a/docs/assets/polished.js
+++ b/docs/assets/polished.js
@@ -3179,10 +3179,10 @@
   /* ::<number | string, string, string> */
   (opacify);
 
-  var defaultLightReturnColor = '#000';
-  var defaultDarkReturnColor = '#fff';
+  var defaultReturnIfLightColor = '#000';
+  var defaultReturnIfDarkColor = '#fff';
   /**
-   * Returns black or white (or optional light and dark return colors) for best
+   * Returns black or white (or optional passed colors) for best
    * contrast depending on the luminosity of the given color.
    * When passing custom return colors, strict mode ensures that the
    * return color always meets or exceeds WCAG level AA or greater. If this test
@@ -3217,27 +3217,27 @@
    * }
    */
 
-  function readableColor(color, lightReturnColor, darkReturnColor, strict) {
-    if (lightReturnColor === void 0) {
-      lightReturnColor = defaultLightReturnColor;
+  function readableColor(color, returnIfLightColor, returnIfDarkColor, strict) {
+    if (returnIfLightColor === void 0) {
+      returnIfLightColor = defaultReturnIfLightColor;
     }
 
-    if (darkReturnColor === void 0) {
-      darkReturnColor = defaultDarkReturnColor;
+    if (returnIfDarkColor === void 0) {
+      returnIfDarkColor = defaultReturnIfDarkColor;
     }
 
     if (strict === void 0) {
       strict = true;
     }
 
-    var isLightColor = getLuminance(color) > 0.179;
-    var preferredReturnColor = isLightColor ? lightReturnColor : darkReturnColor;
+    var isColorLight = getLuminance(color) > 0.179;
+    var preferredReturnColor = isColorLight ? returnIfLightColor : returnIfDarkColor;
 
     if (!strict || getContrast(color, preferredReturnColor) >= 4.5) {
       return preferredReturnColor;
     }
 
-    return isLightColor ? defaultLightReturnColor : defaultDarkReturnColor;
+    return isColorLight ? defaultReturnIfLightColor : defaultReturnIfDarkColor;
   }
 
   /**
diff --git a/docs/docs/index.html b/docs/docs/index.html
index e74e9bcd..138434a1 100644
--- a/docs/docs/index.html
+++ b/docs/docs/index.html
@@ -5077,7 +5077,7 @@ <h3 class='fl m0' id='readablecolor'>
   </div>
   
 
-  <p>Returns black or white (or optional light and dark return colors) for best
+  <p>Returns black or white (or optional passed colors) for best
 contrast depending on the luminosity of the given color.
 When passing custom return colors, strict mode ensures that the
 return color always meets or exceeds WCAG level AA or greater. If this test
@@ -5086,7 +5086,7 @@ <h3 class='fl m0' id='readablecolor'>
 <p>Follows <a href="https://www.w3.org/TR/WCAG20-TECHS/G18.html">W3C specs for readability</a>.</p>
 
 
-  <div class='pre p1 fill-light mt0'>readableColor(color: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, lightReturnColor: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, darkReturnColor: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, strict: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>): <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></div>
+  <div class='pre p1 fill-light mt0'>readableColor(color: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, returnIfLightColor: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, returnIfDarkColor: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, strict: <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>): <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></div>
   
   
     <p>
@@ -5117,8 +5117,8 @@ <h3 class='fl m0' id='readablecolor'>
       
         <div class='space-bottom0'>
           <div>
-            <span class='code bold'>lightReturnColor</span> <code class='quiet'>(<a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>
-            = <code>defaultLightReturnColor</code>)</code>
+            <span class='code bold'>returnIfLightColor</span> <code class='quiet'>(<a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>
+            = <code>defaultReturnIfLightColor</code>)</code>
 	    
           </div>
           
@@ -5126,8 +5126,8 @@ <h3 class='fl m0' id='readablecolor'>
       
         <div class='space-bottom0'>
           <div>
-            <span class='code bold'>darkReturnColor</span> <code class='quiet'>(<a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>
-            = <code>defaultDarkReturnColor</code>)</code>
+            <span class='code bold'>returnIfDarkColor</span> <code class='quiet'>(<a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>
+            = <code>defaultReturnIfDarkColor</code>)</code>
 	    
           </div>