diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index a25a38edb2..d6e8934389 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1134,6 +1134,15 @@
                     the Yocto Project release.
                     Be aware and take precautions for that possibility.
                     </para></listitem>
+                <listitem><para>
+                    The <filename>armv7a</filename> with thumb package
+                    architecture suffix has changed.
+                    The suffix for these packages with the thumb
+                    optimization enabled is "t2" as it should be.
+                    Use of this suffix was not the case in the 1.5 release.
+                    Architecture names will change within package feeds as a
+                    result.
+                    </para></listitem>
             </itemizedlist>
         </para>
     </section>