diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 71ab7b27f1..756736eff4 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -5742,6 +5742,15 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
 
         <para>
             The "_remove" operator now preserves whitespace.
+            Consequently, when specifying list items to remove, be aware
+            that leading and trailing whitespace resulting from the
+            removal is retained.
+        </para>
+
+        <para>
+            See the
+            "<ulink url='&YOCTO_DOCS_BB_URL;#removing-override-style-syntax'>Removal (Override Style Syntax)</ulink>"
+            section in the BitBake User Manual for a detailed example.
         </para>
     </section>