diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index f46d230577..f91b619955 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -4687,14 +4687,17 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
 
                     <para>The <filename>DISTRO_FEATURES</filename> for
                     <filename>native</filename> recipes is
-                    <filename>DISTRO_FEATURES_NATIVE</filename> added to an
-                    intersection of <filename>DISTRO_FEATURES</filename> and
-                    <filename>DISTRO_FEATURES_FILTER_NATIVE</filename>.</para>
+                    <link linkend='var-DISTRO_FEATURES_NATIVE'><filename>DISTRO_FEATURES_NATIVE</filename></link>
+                    added to an intersection of
+                    <filename>DISTRO_FEATURES</filename> and
+                    <link linkend='var-DISTRO_FEATURES_FILTER_NATIVE'><filename>DISTRO_FEATURES_FILTER_NATIVE</filename></link>.
+                    </para>
 
                     <para>For nativesdk recipes, the
                     corresponding variables are
-                    <filename>DISTRO_FEATURES_NATIVESDK</filename> and
-                    <filename>DISTRO_FEATURES_FILTER_NATIVESDK</filename>.
+                    <link linkend='var-DISTRO_FEATURES_NATIVESDK'><filename>DISTRO_FEATURES_NATIVESDK</filename></link>
+                    and
+                    <link linkend='var-DISTRO_FEATURES_FILTER_NATIVESDK'><filename>DISTRO_FEATURES_FILTER_NATIVESDK</filename></link>.
                     </para></listitem>
                 <listitem><para>
                     The <filename>FILESDIR</filename>