Skip to content

Conversation

@alistairmatthews
Copy link
Contributor

@alistairmatthews alistairmatthews commented Oct 8, 2025

Summary

Revises the Quickstart: Build your first Aspire solution article.

  • Creates a new zone pivot group with two pivots: Aspire CLI and VS Code.
  • Adds Aspire CLI steps.
  • Refreshes out-of-date screenshots.
  • Simplifies the article.

Partially Fixes #3859


Internal previews

📄 File 🔗 Preview link
docs/get-started/build-your-first-aspire-app.md Quickstart: Build your first Aspire solution
docs/zones/zone-pivot-groups.yml docs/zones/zone-pivot-groups

@alistairmatthews
Copy link
Contributor Author

@IEvangelist I've left in the Explore the Aspire Dashboard and Understand the Aspire solution structure sections, but you may think they should go as well.

Do you know if the material about installing a self-signed certificate is still relevant? It doesn't appear on my machine but I probably have it set up already.

@IEvangelist IEvangelist closed this Oct 9, 2025
@IEvangelist IEvangelist reopened this Oct 9, 2025
@IEvangelist
Copy link
Member

Closing/Reopening PR to force the preview build that was stuck.

Copy link
Member

@IEvangelist IEvangelist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great so far, I fixed a merge conflict and also - closed/opened the PR to trigger a build again as it was stuck. For the Visual Studio Code section could you please add details on using the official extension and update those parts as well?

@IEvangelist
Copy link
Member

IEvangelist commented Oct 9, 2025

Do you know if the material about installing a self-signed certificate is still relevant? It doesn't appear on my machine but I probably have it set up already.

I think it's not required anymore (the CLI should install it), maybe we link out to the troubleshooting, since I thought we had something on that there. Perhaps as an alert?

@alistairmatthews alistairmatthews marked this pull request as ready for review October 10, 2025 15:33
Copilot AI review requested due to automatic review settings October 10, 2025 15:33
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR revises the "Build your first Aspire solution" quickstart article to improve the user experience by adding support for the Aspire CLI and updating the Visual Studio Code workflow. The revision simplifies the article structure while providing clearer guidance for getting started with Aspire.

  • Introduces a new zone pivot system with three development tool options: Aspire CLI, Visual Studio Code, and Visual Studio
  • Updates the Visual Studio Code workflow to use the official Aspire extension and CLI integration
  • Adds comprehensive Aspire CLI instructions for creating new solutions
  • Removes extensive code exploration sections to focus on the quickstart experience

Reviewed Changes

Copilot reviewed 4 out of 13 changed files in this pull request and generated 1 comment.

File Description
docs/zones/zone-pivot-groups.yml Adds new "dev-tools" pivot group with Aspire CLI, VS Code, and Visual Studio options
docs/includes/vscode-file-new.md Updates VS Code workflow to install Aspire extension and use CLI integration
docs/includes/aspire-cli-new-app.md Adds new include file with step-by-step Aspire CLI instructions
docs/get-started/build-your-first-aspire-app.md Major revision removing code exploration sections and updating pivot structure

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Simplify getting started content

2 participants