diff --git a/docs/src/modules/ROOT/nav.adoc b/docs/src/modules/ROOT/nav.adoc
index af15cb5bcc2..7c51face971 100644
--- a/docs/src/modules/ROOT/nav.adoc
+++ b/docs/src/modules/ROOT/nav.adoc
@@ -79,6 +79,8 @@
 ** Migration guides
 *** xref:upgrading-timefold-solver/migration-guides/variable-listeners-to-custom-shadow-variables.adoc[leveloffset=+1]
 *** xref:upgrading-timefold-solver/migration-guides/chained-variables-to-planning-list-variable.adoc[leveloffset=+1]
+*** xref:upgrading-timefold-solver/migration-guides/shadow-variables-inconsistent-to-structural-score.adoc[leveloffset=+1]
+
 * Commercial editions
 ** xref:commercial-editions/commercial-editions.adoc[Overview]
 ** xref:commercial-editions/installation.adoc[Installation]
diff --git a/docs/src/modules/ROOT/pages/upgrading-timefold-solver/migration-guides/shadow-variables-inconsistent-to-structural-score.adoc b/docs/src/modules/ROOT/pages/upgrading-timefold-solver/migration-guides/shadow-variables-inconsistent-to-structural-score.adoc
index b1b7070a87c..bce3f33c58a 100644
--- a/docs/src/modules/ROOT/pages/upgrading-timefold-solver/migration-guides/shadow-variables-inconsistent-to-structural-score.adoc
+++ b/docs/src/modules/ROOT/pages/upgrading-timefold-solver/migration-guides/shadow-variables-inconsistent-to-structural-score.adoc
@@ -1,5 +1,5 @@
 [#migrateShadowVariablesInconsistent]
-= `@ShadowVariablesInconsistent` to structural scores
+= @ShadowVariablesInconsistent to structural scores
 :doctype: book
 :icons: font