diff --git a/README.md b/README.md
index 01ed5be..c20edab 100644
--- a/README.md
+++ b/README.md
@@ -96,8 +96,8 @@ These methods follow a fluent style, so as, they can be concatenated in a single
 
 - `setReportSubdir(String reportSubdir)`: Sets the folder where generated files with the differences are stored (default is `target`).
 - `setNormalizeEol(boolean normalizeEol)`: If set to true, the compared strings are normalized to linux line-endings by removing all CR characters.
-- `setSoftDifferences(boolean useSoftDifferences)`: By default (hard), differences in whitespaces are rendered as whitespace html entities and therefore, always visible in the html ouput.
-If set to true (soft), some whitespace differences may be hidden from the html output.
+- `setSoftDifferences(boolean useSoftDifferences)`: By default (hard), html differences are displayed inside a pre tag.
+  If set to true (soft), some whitespace differences and indentation may be hidden from the html output.
 - `setBrightColors(boolean useBrightColors)`: By default, differences are highlighted with pale red and green colors,
   if set to true the colors are brighter to easily locate small differences.
 - `setDiffFileQualifier(String value)`: When assertions do not specify a diff file name, adds the indicated string to