Revision of the Build your first Aspire solution article.

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

@@ -0,0 +1,18 @@
+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.

docs/includes/vscode-file-new.md

@@ -1,8 +1,21 @@
-Visual Studio Code provides Aspire project templates that handle some initial setup configurations for you. Complete the following steps to create a project for this quickstart:
+Visual Studio Code provides Aspire project templates that handle some initial setup configurations for you and there is an Aspire official extension that integrates Visual Studio Code more closely with Aspire. Complete the following steps to install the extension:
 
-1. From a new instance of Visual Studio Code (without a folder open), select **Create .NET project** button.
-1. Select the **Aspire Starter App** template.
+1. From a new instance of Visual Studio Code (without a folder open), select the **Extensions** tab or press <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>X</kbd>.
+1. In the **Search in Extensions in Marketplace** textbox, type **Aspire** and then select the official Aspire extension.
+1. Select **Install**. Visual Studio Code installs the extension.
+
+    :::image type="content" loc-scope="vs-code" source="media/vscode-install-aspire-extension.png" lightbox="media/vscode-install-aspire-extension.png" alt-text="A screenshot of the Visual Studio Code installing the Aspire official extension.":::
+
+Now, you can use the extension to create a new Aspire solution. Complete the following steps to create a solution for this quickstart:
+
+1. In Visual Studio Code, select **View** > **Command Palette** or press <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>P</kbd>.
+1. Type **Aspire**, and then select **Aspire: New Aspire project**. Visual Studio Code opens a new terminal and starts the Aspire CLI.
 
     :::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. When prompted for a project template, select **Starter template**.
+1. Enter a name for the project, and then press <kbd>ENTER</kbd>.
+1. Enter an output path for the new project, and then press <kbd>ENTER</kbd>.
+1. Select a template version for the project. The default 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.

docs/zones/zone-pivot-groups.yml

@@ -43,6 +43,16 @@ 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: visual-studio
+    title: Visual Studio
 - id: resp-host
   title: Hosting resource type
   prompt: Choose a hosting resource that supports the Redis protocol