diff --git a/UPGRADE-3.2.md b/UPGRADE-3.2.md
index 39b5ba0dca..a4f709324f 100644
--- a/UPGRADE-3.2.md
+++ b/UPGRADE-3.2.md
@@ -77,5 +77,6 @@ Yaml
  * Support for silently ignoring duplicate keys in YAML has been deprecated and
    will lead to a `ParseException` in Symfony 4.0.
 
- * Mappings with a colon that is not followed by a space are deprecated and
-   will lead to a `ParseException` in Symfony 4.0.
+ * Mappings with a colon (`:`) that is not followed by a whitespace are deprecated
+   and will lead to a `ParseException` in Symfony 4.0 (e.g. `foo:bar` must be
+   `foo: bar`).
diff --git a/UPGRADE-4.0.md b/UPGRADE-4.0.md
index 014d2393e0..ef64f15d1d 100644
--- a/UPGRADE-4.0.md
+++ b/UPGRADE-4.0.md
@@ -147,8 +147,9 @@ Translation
 Yaml
 ----
 
- * Mappings with a colon that is not followed by a space are are not
-   supported anymore and lead to a `ParseException`.
+ * Mappings with a colon (`:`) that is not followed by a whitespace are not
+   supported anymore and lead to a `ParseException`(e.g. `foo:bar` must be
+   `foo: bar`).
 
  * Starting an unquoted string with `%` leads to a `ParseException`.
 
diff --git a/src/Symfony/Component/Yaml/CHANGELOG.md b/src/Symfony/Component/Yaml/CHANGELOG.md
index b321cf0ca8..3fcebe554c 100644
--- a/src/Symfony/Component/Yaml/CHANGELOG.md
+++ b/src/Symfony/Component/Yaml/CHANGELOG.md
@@ -4,8 +4,9 @@ CHANGELOG
 3.2.0
 -----
 
- * Mappings with a colon that is not followed by a space are deprecated and
-   will lead to a `ParseException` in Symfony 4.0.
+ * Mappings with a colon (`:`) that is not followed by a whitespace are deprecated
+   and will lead to a `ParseException` in Symfony 4.0 (e.g. `foo:bar` must be
+   `foo: bar`).
 
  * Added support for parsing PHP constants: