Basic docs structure overhaul

Author: jvalkeal

docs/modules/ROOT/nav.adoc

@@ -1,18 +1,25 @@
 * xref:index.adoc[Overview]
 * xref:installation.adoc[Installation]
 * xref:getting-started.adoc[Getting Started]
-* xref:creating-new-projects.adoc[Creating New Projects]
-* xref:registering-new-projects.adoc[Registering Projects]
-* xref:adding-to-existing-projects.adoc[Adding to Existing Projects]
-* xref:boot-add-guide.adoc[Using "boot add"]
-* xref:ai-guide.adoc[Guide to "ai Commands"]
-* xref:user-command-guide.adoc[User defined Commands]
-* xref:action-file-overview.adoc[Overview of Action Files]
-* xref:action-guide.adoc[Guide to Action Files]
-* xref:roles-guide.adoc[Guide to Roles]
-* xref:special-commands-guide.adoc[Guide to Special Commands]
-* xref:initializr.adoc[Guide to Initializr Commands]
-* xref:readme-command-guide.adoc[Guide to README Commands]
 * xref:key-concepts.adoc[Key Concepts]
-* xref:comments-on-the-approach.adoc[Comments on the Approach]
+* xref:ref/index.adoc[]
+** xref:ref/project/index.adoc[]
+*** xref:ref/project/creating-new-projects.adoc[Creating New Projects]
+*** xref:ref/project/comments-on-the-approach.adoc[Comments on the Approach]
+*** xref:ref/project/adding-to-existing-projects.adoc[Adding to Existing Projects]
+** xref:ref/catalog/index.adoc[]
+*** xref:ref/catalog/registering-new-projects.adoc[]
+** xref:ref/actionfile/index.adoc[]
+*** xref:ref/actionfile/action-guide.adoc[Guide to Action Files]
+*** xref:ref/actionfile/roles-guide.adoc[Guide to Roles]
+** xref:ref/usercommand/index.adoc[]
+*** xref:ref/usercommand/user-command-guide.adoc[User defined Commands]
+*** xref:ref/usercommand/action-file-overview.adoc[Overview of Action Files]
+** xref:ref/ai/index.adoc[]
+*** xref:ref/ai/readme-command-guide.adoc[Guide to README Commands]
+* xref:howto/index.adoc[]
+** xref:howto/boot-add-guide.adoc[Using "boot add"]
+** xref:howto/ai-guide.adoc[Guide to "ai Commands"]
+** xref:howto/special-commands-guide.adoc[Guide to Special Commands]
+** xref:howto/initializr.adoc[Guide to Initializr Commands]
 * xref:glossary.adoc[Glossary]

docs/modules/ROOT/pages/getting-started.adoc

@@ -15,7 +15,7 @@ Created project in directory 'my-app'
 ----
 
 NOTE: If the CLI seems to be stuck at the cloning step, you might be hitting GitHub rate limiting. Use the `spring github auth login` command to authenticate.
- 
+
 You can now `cd` into the `my-app` directory and build and run the application, which is,  by default, a simple web application with a single endpoint:
 
 [source, bash]
@@ -42,6 +42,6 @@ The README.adoc file in the new project contains more information on how the web
 
 == Next steps
 
-The xref:creating-new-projects.adoc[Creating New Projects] section shows you how to create applications other than the default application.
+The xref:ref/project/creating-new-projects.adoc[Creating New Projects] section shows you how to create applications other than the default application.
 
-The xref:adding-to-existing-projects.adoc[Adding To Existing Projects] section shows you how to add additional applications into your current working project.
+The xref:ref/project/adding-to-existing-projects.adoc[Adding To Existing Projects] section shows you how to add additional applications into your current working project.

docs/modules/ROOT/pages/ai-guide.adoc renamed to docs/modules/ROOT/pages/howto/ai-guide.adoc

@@ -0,0 +1,3 @@
+= How-to Guides
+
+This section provides answers to some common ‘how do I do that…​’ questions that often arise when using Spring CLI. Its coverage is not exhaustive, but it does cover quite a lot.

docs/modules/ROOT/pages/boot-add-guide.adoc renamed to docs/modules/ROOT/pages/howto/boot-add-guide.adoc

@@ -31,7 +31,7 @@ actions:
 The `{{user-name}}` and `{{os-name}}` variables are replaced with actual values by the Handlebars template engine.
 Command line options passed to user-defined command are exposed as variables to be used by the template engine.
 
-For more information on predefined template engine variables, see the xref:user-command-guide.adoc#_template_engine[Template Engine] section.
+For more information on predefined template engine variables, see the xref:ref/usercommand/user-command-guide.adoc#_template_engine[Template Engine] section.
 
 === Literal Syntax
 
@@ -96,7 +96,7 @@ The following listing shows its contents:
 }
 ```
 
-Running `spring hello create` from the xref:action-file-overview.adoc#_an_introductory_example[introductory example] produces a file called `hello.json`, as follows:
+Running `spring hello create` from the xref:ref/usercommand/action-file-overview.adoc#_an_introductory_example[introductory example] produces a file called `hello.json`, as follows:
 
 ```
 $ spring hello create
@@ -133,7 +133,7 @@ actions:
       from: RestController.java
 ```
 
-For more information on predefined template engine variables, see the xref:user-command-guide.adoc#_template_engine[Template Engine] section.
+For more information on predefined template engine variables, see the xref:ref/usercommand/user-command-guide.adoc#_template_engine[Template Engine] section.
 
 [[action-inject]]
 == Inject

docs/modules/ROOT/pages/howto/index.adoc

@@ -0,0 +1,3 @@
+= Action Files
+
+These define the actions that can be taken on a project.