Skip to content

Clarify template installation guidance: CLI-first flow with .NET fallback#1156

Open
IEvangelist with Copilot wants to merge 2 commits into
mainfrom
copilot/install-aspire-templates-dotnet
Open

Clarify template installation guidance: CLI-first flow with .NET fallback#1156
IEvangelist with Copilot wants to merge 2 commits into
mainfrom
copilot/install-aspire-templates-dotnet

Conversation

Copilot AI commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

The templates page implied dotnet new install applied broadly and referenced the obsolete “Aspire workload,” which caused confusion about the intended setup path. This update makes aspire new the primary flow and scopes dotnet new install explicitly to .NET template installation fallback.

  • Primary path: Aspire CLI

    • Replaced the top-level install section with a CLI-first section: “Install templates with Aspire CLI (recommended)”.
    • Clarified that aspire new handles template installation automatically.
  • .NET-specific fallback

    • Added a clearly scoped subsection: “Install the .NET project templates (dotnet fallback)”.
    • Kept dotnet new install Aspire.ProjectTemplates guidance and version pinning example, but explicitly framed it as direct dotnet installation.
  • Terminology cleanup

    • Removed the outdated “Aspire workload” phrasing from this page section.
# Recommended
aspire new aspire-starter

# .NET fallback
dotnet new install Aspire.ProjectTemplates
dotnet new install Aspire.ProjectTemplates::13.1.0

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Clarify 'Install the Aspire Templates' section for dotnet Clarify template installation guidance: CLI-first flow with .NET fallback Jun 2, 2026
Copilot AI requested a review from IEvangelist June 2, 2026 02:43
@IEvangelist IEvangelist marked this pull request as ready for review June 30, 2026 08:38
Copilot AI review requested due to automatic review settings June 30, 2026 08:38

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 updates the “Aspire SDK templates” getting-started documentation to make the Aspire CLI the primary workflow for using templates, while clearly scoping dotnet new install to a .NET-specific fallback path.

Changes:

  • Replaces the top-level “install templates” guidance with a CLI-first aspire new flow.
  • Adds a clearly labeled “dotnet fallback” subsection for installing templates into dotnet.
  • Removes the outdated “Aspire workload” phrasing from this page section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

## Install templates with Aspire CLI (recommended)

The Aspire templates are included with the Aspire workload. To install the templates, run the following command:
Use `aspire new` to create a project or solution. The Aspire CLI ensures the required templates are installed automatically.
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.

"Install the Aspire Templates" section should be clear it's referring specifically to dotnet

3 participants