diff --git a/README.md b/README.md
index 412217d29..4dbb7272b 100644
--- a/README.md
+++ b/README.md
@@ -363,7 +363,7 @@ Install the default font supported by Spacemacs or choose a fixed witdh font.
 More information in the [font section][] of the documentation.
 
 4. **The powerline separators are ugly, how can I fix them ?**
-Use the property `:powerline-offset` of the variable
+Use the property `:powerline-scale` of the variable
 `dotspacemacs-default-font`. More information in the [font section][]
 of the documentation.
 
diff --git a/doc/DOCUMENTATION.md b/doc/DOCUMENTATION.md
index 9764f14b8..93cf68d20 100644
--- a/doc/DOCUMENTATION.md
+++ b/doc/DOCUMENTATION.md
@@ -848,7 +848,7 @@ By default its value is:
                                           :size 13
                                           :weight normal
                                           :width normal
-                                          :powerline-offset 2))
+                                          :powerline-scale 1.1))
 ```
 
 The properties should be pretty straightforward, it is possible to set any
@@ -876,17 +876,12 @@ units of 1/10 point.
   - light
   - extra-light
   - ultra-light
-On text terminals which support variable-brightness text, any weight greater
-than normal is displayed as extra bright, and any weight less than normal is
-displayed as half-bright.
 - `:slant` Font slant—one of the symbols:
   - italic
   - oblique
   - normal
   - reverse-italic
-  - reverse-oblique.
-On text terminals that support variable-brightness text, slanted text is
-displayed as half-bright. 
+  - reverse-oblique
 - `:size` The font size—either a non-negative integer that specifies the pixel
 size, or a floating-point number that specifies the point size. 
 - `:adstyle` Additional typographic style information for the font, such as
@@ -895,10 +890,9 @@ size, or a floating-point number that specifies the point size.
 ‘iso8859-1’. The value should be a string or a symbol. 
 - `:script` The script that the font must support (a symbol). 
 
-The special property `:powerline-offset` is `Spacemacs` specific and it is for
+The special property `:powerline-scale` is `Spacemacs` specific and it is for
 quick tweaking of the mode-line height in order to avoid crappy rendering of
-the separators like on the following screenshot (in this extreme case bump the
-offset to `+8` or more but most of the time `2` or `4` is alright).
+the separators like on the following screenshot (default value is 1.1).
 
 _Ugly separators_