Update documentation

Author: fmbenhassine

pom.xml

@@ -93,7 +93,7 @@
 		<module>spring-shell-test</module>
 		<module>spring-shell-autoconfigure</module>
 		<module>spring-shell-test-autoconfigure</module>
-<!--		<module>spring-shell-docs</module>-->
+		<module>spring-shell-docs</module>
 		<module>spring-shell-dependencies</module>
 		<module>spring-shell-samples</module>
 		<module>spring-shell-starters</module>

spring-shell-docs/modules/ROOT/nav.adoc

@@ -8,40 +8,16 @@
 ** xref:commands/registration/programmatic.adoc[]
 ** xref:commands/registration/annotation.adoc[]
 ** xref:commands/organize.adoc[]
-** xref:commands/availability.adoc[]
-** xref:commands/exceptionhandling/index.adoc[]
-*** xref:commands/exceptionhandling/resolving.adoc[]
-*** xref:commands/exceptionhandling/mappings.adoc[]
-*** xref:commands/exceptionhandling/annotation.adoc[]
-** xref:commands/alias.adoc[]
-** xref:commands/hidden.adoc[]
-** xref:commands/helpoptions.adoc[]
-** xref:commands/interactionmode.adoc[]
+** xref:commands/syntax.adoc[]
+** xref:commands/context.adoc[]
+** xref:commands/registry.adoc[]
+** xref:commands/help.adoc[]
 ** xref:commands/builtin/index.adoc[]
 *** xref:commands/builtin/help.adoc[]
 *** xref:commands/builtin/clear.adoc[]
 *** xref:commands/builtin/exit.adoc[]
-*** xref:commands/builtin/stacktrace.adoc[]
-*** xref:commands/builtin/script.adoc[]
-*** xref:commands/builtin/history.adoc[]
-*** xref:commands/builtin/completion.adoc[]
 *** xref:commands/builtin/version.adoc[]
 ** xref:commands/writing.adoc[]
-* xref:options/index.adoc[]
-** xref:options/basics/index.adoc[]
-*** xref:options/basics/programmatic.adoc[]
-*** xref:options/basics/annotation.adoc[]
-*** xref:options/basics/legacyannotation.adoc[]
-** xref:options/short.adoc[]
-** xref:options/arity.adoc[]
-** xref:options/positional.adoc[]
-** xref:options/optional.adoc[]
-** xref:options/default.adoc[]
-** xref:options/validation.adoc[]
-** xref:options/label.adoc[]
-** xref:options/types.adoc[]
-** xref:options/naming.adoc[]
-* xref:completion.adoc[]
 * xref:building.adoc[]
 * xref:components/index.adoc[]
 ** xref:components/flow/index.adoc[]
@@ -76,25 +52,15 @@
 * xref:customization/index.adoc[]
 ** xref:customization/styling.adoc[]
 ** xref:customization/logging.adoc[]
-** xref:customization/commandnotfound.adoc[]
-** xref:customization/singlecommand.adoc[]
 ** xref:customization/contextclose.adoc[]
 * xref:execution.adoc[]
-* xref:testing/index.adoc[]
-** xref:testing/basics.adoc[]
-** xref:testing/settings.adoc[]
 * Appendices
 ** xref:appendices/techintro/index.adoc[]
-*** xref:appendices/techintro/registration.adoc[]
 *** xref:appendices/techintro/parser.adoc[]
 *** xref:appendices/techintro/execution.adoc[]
-*** xref:appendices/techintro/shellcontext.adoc[]
-*** xref:appendices/techintro/commandcontext.adoc[]
-*** xref:appendices/techintro/commandcatalog.adoc[]
 *** xref:appendices/techintro/theming.adoc[]
 *** xref:appendices/techintro/searchalgorithm.adoc[]
 ** xref:appendices/debugging/index.adoc[]
 ** xref:appendices/tui/index.adoc[]
 *** xref:appendices/tui/viewdev.adoc[]
-*** xref:appendices/tui/catalog.adoc[]
 * xref:api:attachment$index.html[Javadoc,role=link-external,window=_blank].

spring-shell-docs/modules/ROOT/pages/appendices/techintro/commandcontext.adoc

@@ -7,11 +7,11 @@ we need to go through some of the fundamental concepts of Spring Shell.
 
 Essentially, a few things needs to happen before you have a working Spring Shell application:
 
-- Create a Spring Boot application.
+- Create a Spring (Boot) application.
 - Define commands and options.
 - Package the application.
 - Run the application, either interactively or non-interactively.
 
-You can get a full working Spring Shell application without defining any user-level commands
-as some basic built-in commands (such as `help` and `history`) are provided.
+You can get a fully working Spring Shell application without defining any user-level commands
+as some basic built-in commands (such as `help` and `clear`) are provided.
 

spring-shell-docs/modules/ROOT/pages/appendices/techintro/commandregistry.adoc

@@ -5,13 +5,8 @@
 Throughout this documentation, we make references to configuring something by using
 annotations or programmatic examples.
 
-NOTE: There are two annotation models: the xref:commands/registration/annotation.adoc[annotations] model
-referred to as the new annotation model, and the xref:commands/registration/legacyannotation.adoc[legacy annotations]
-model referred to as the old legacy annotation model.
+The annotation model relates to the use of `@Command`.
 
-The old legacy annotation model mostly relates to the use of `@ShellMethod` and `@ShellOption` and
-the new annotation model relates to the use of `@Command`.
+The programmatic model relates to creating commands using APIs such as `Command.Builder`.
 
-The programmatic model is how things are actually registered, even if you use annotations.
-
-NOTE: The documentation structure is getting revised to clarify how to provide configurations in separate ways.
+These approaches can be mixed in the same application.