diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 756736eff4..466081d526 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -5728,7 +5728,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
             <ulink url='https://www.openssl.org/'>OpenSSL</ulink> has been
             upgraded from 1.0 to 1.1.
             By default, this upgrade could cause problems for recipes that
-            have both versions their dependency chains.
+            have both versions in their dependency chains.
             The problem is that both versions cannot be installed together
             at build time.
             <note>
@@ -5758,9 +5758,9 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
         <title>Security Changes</title>
 
         <para>
-            The Poky distribution now uses security compiler files by
+            The Poky distribution now uses security compiler flags by
             default.
-            Inclusion of these files could cause new failures due to stricter
+            Inclusion of these flags could cause new failures due to stricter
             checking for various potential security issues in code.
         </para>
     </section>