diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index d987772058..a25a38edb2 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1129,6 +1129,11 @@
                     moved to a dedicated
                     <filename>gtk-engines-schemas</filename> package.
                     </para></listitem>
+                <listitem><para>
+                    Issues could arise with forked packages when upgrading
+                    the Yocto Project release.
+                    Be aware and take precautions for that possibility.
+                    </para></listitem>
             </itemizedlist>
         </para>
     </section>