diff --git a/spring-shell-docs/src/main/asciidoc/using-shell-commands-annotationmodel.adoc b/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration-legacyannotation.adoc
similarity index 100%
rename from spring-shell-docs/src/main/asciidoc/using-shell-commands-annotationmodel.adoc
rename to spring-shell-docs/src/main/asciidoc/using-shell-commands-registration-legacyannotation.adoc
diff --git a/spring-shell-docs/src/main/asciidoc/using-shell-commands-programmaticmodel.adoc b/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration-programmatic.adoc
similarity index 100%
rename from spring-shell-docs/src/main/asciidoc/using-shell-commands-programmaticmodel.adoc
rename to spring-shell-docs/src/main/asciidoc/using-shell-commands-registration-programmatic.adoc
diff --git a/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration.adoc b/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration.adoc
index 5fa4cec5..bd3a16a3 100644
--- a/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration.adoc
+++ b/spring-shell-docs/src/main/asciidoc/using-shell-commands-registration.adoc
@@ -7,6 +7,6 @@ in a class and annotate the class and the methods with specific annotations.
 In the programmatic model, you use a more low level approach, defining command
 registrations (either as beans or by dynamically registering with a command catalog).
 
-include::using-shell-commands-annotationmodel.adoc[]
+include::using-shell-commands-registration-legacyannotation.adoc[]
 
-include::using-shell-commands-programmaticmodel.adoc[]
+include::using-shell-commands-registration-programmatic.adoc[]