Revision of the Build your first Aspire solution article.

docs/includes/aspire-cli-new-app.md

@@ -0,0 +1,21 @@
+The Aspire CLI can lead you through the choices necessary to create a new Aspire solution, based on one of the Aspire templates. Complete the following steps to create a project for this quickstart:
+
+1. Open a command prompt and navigate to a folder where you want to work. The Aspire CLI will create a new subdirectory and places the entire solution in it.
+1. To run the Aspire CLI, execute the following command:
+
+    ```Aspire
+    aspire new
+    ```
+
+1. The Aspire CLI presents a list of templates for you to choose from. Select `Starter template` and then press <kbd>Enter</kbd>.
+
+    :::image type="content" source="media/aspire-cli-new-select-template.png" lightbox="media/aspire-cli-new-select-template.png" alt-text="A screenshot of the command prompt running the Aspire CLI.":::
+
+1. Enter a name for the new solution, and then press <kbd>Enter</kbd>.
+1. Enter a folder for the new solution. The default name is the solution name that you just entered.
+1. Select the default version of Aspire, which is the latest version on NuGet. Alternatively you can select the latest daily or stable builds of Aspire.
+1. Choose `Yes` to include a Redis Cache integration in the solution.
+1. Choose `No` to exclude a test project from the solution. The Aspire CLI creates the new solution.
+
+> [!NOTE]
+> You chose not to add a test project to the new solution. You can always add a test project later but it's not needed for this quickstart.

docs/includes/aspire-cli-new-app.md~

@@ -0,0 +1,21 @@
+The Aspire CLI can lead you through the choices necessary to create a new Aspire solution, based on one of the Aspire templates. Complete the following steps to create a project for this quickstart:
+
+1. Open a command prompt and navigate to a folder where you want to work. The Aspire CLI will create a new subdirectory and places the entire solution in it.
+1. To run the Aspire CLI, execute the following command:
+
+    ```aspire-cli
+    aspire new
+    ```
+
+1. The Aspire CLI presents a list of templates for you to choose from. Select `Starter template` and then press <kbd>Enter</kbd>.
+
+    :::image type="content" source="media/aspire-cli-new-select-template.png" lightbox="media/aspire-cli-new-select-template.png" alt-text="A screenshot of the command prompt running the Aspire CLI.":::
+
+1. Enter a name for the new solution, and then press <kbd>Enter</kbd>.
+1. Enter a folder for the new solution. The default name is the solution name that you just entered.
+1. Select the default version of Aspire, which is the latest version on NuGet. Alternatively you can select the latest daily or stable builds of Aspire.
+1. Choose `Yes` to include a Redis Cache integration in the solution.
+1. Choose `No` to exclude a test project from the solution. The Aspire CLI creates the new solution.
+
+> [!NOTE]
+> You chose not to add a test project to the new solution. You can always add a test project later but it's not needed for this quickstart.

docs/includes/vscode-file-new.md

@@ -5,4 +5,4 @@ Visual Studio Code provides Aspire project templates that handle some initial se
 
     :::image type="content" loc-scope="vs-code" source="media/vscode-create-starter-app.png" lightbox="media/vscode-create-starter-app.png" alt-text="A screenshot of the Aspire Starter App template.":::
 
-1. Select a folder for the new project, and the enter a name for it.
+1. Select a folder for the new project, and then enter a name for it.

docs/zones/zone-pivot-groups.yml

@@ -43,6 +43,14 @@ groups:
     title: Visual Studio
   - id: dotnet-cli
     title: .NET CLI
+- id: dev-tools
+  title: Development tools
+  prompt: Choose your preferred development tools
+  pivots:
+  - id: aspire-cli
+    title: Aspire CLI
+  - id: vscode
+    title: Visual Studio Code
 - id: resp-host
   title: Hosting resource type
   prompt: Choose a hosting resource that supports the Redis protocol