Reframe generic Getting Started docs with multi-language-first wording by Copilot · Pull Request #877 · microsoft/aspire.dev

Copilot · 2026-05-07T13:42:39Z

Review new PR comment and identify requested action
Update PR description so it does not include auto-closing keywords for Replace "non-.NET" phrasing across docs #559
Validate no code changes are required
Reply on the comment thread with confirmation

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/907fb32d-bab4-4c07-9f94-67a069a248c4 Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>

davidfowl · 2026-05-07T14:53:06Z

    />

-    At this point, the Aspire CLI has been installed and the ASP.NET Core development certificate has been created and trusted inside the Codespace. You can use `aspire new` right away without manually installing `Aspire.ProjectTemplates`.
+    At this point, the Aspire CLI has been installed and the local HTTPS development certificate for .NET workloads has been created and trusted inside the Codespace. You can use `aspire new` right away without manually installing `Aspire.ProjectTemplates`.


We should stay away from the workloads term. That has a meaning in .NET land and aspire used to have a .NET workload.

Updated in 763ae9d: replaced for .NET workloads with for .NET apps to avoid workload terminology. Screenshot: /tmp/aspire-review-shots/.tmp-github-codespaces-review.png.

alistairmatthews

@copilot Please address my comments.

alistairmatthews · 2026-05-07T14:45:37Z

For consistency, change the .NET logo to the C# equivalent, if there is one.

Updated in 763ae9d: the C#-scoped AppHost Mermaid diagrams now use the C# logo token (logos:c-sharp) instead of .NET. Screenshot: /tmp/aspire-review-shots/.tmp-app-host-review.png.

alistairmatthews · 2026-05-07T14:51:07Z

 The basic Aspire Dev Container template works well for simple scenarios, but you might need additional configuration depending on your specific requirements. The following sections provide examples for various common scenarios.

-### Stateless .NET apps only
+### Stateless C#/.NET apps only


Adding "C#/" here doesn't change anything. Please revert to:

Suggested change

### Stateless C#/.NET apps only

### Stateless .NET apps only

Done in 763ae9d: reverted that heading to ### Stateless .NET apps only as suggested. Screenshot: /tmp/aspire-review-shots/.tmp-dev-containers-review.png.

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/a6197f20-514c-44e5-9c61-01198699b4dd Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>

Copilot · 2026-05-07T15:05:54Z

@copilot Please address my comments.

Addressed in 763ae9d. All requested review comments are now applied and validated (lint + test:unit:docs). Screenshots: /tmp/aspire-review-shots/.tmp-app-host-review.png, /tmp/aspire-review-shots/.tmp-dev-containers-review.png, /tmp/aspire-review-shots/.tmp-github-codespaces-review.png.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

telemetry.astro.build
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./node_modules/.bin/../astro/bin/astro.mjs sync (dns block)
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/bin/astro.mjs dev -- --host 127.0.0.1 --port 4321 (dns block)
unpkg.com
- Triggering command: /home/REDACTED/.cache/ms-playwright/chromium_headless_shell-1217/chrome-headless-shell-linux64/chrome-headless-shell /home/REDACTED/.cache/ms-playwright/chromium_headless_shell-1217/chrome-headless-shell-linux64/chrome-headless-shell --disable-field-trial-config --disable-REDACTED-networking --disable-REDACTED-timer-throttling --disable-REDACTEDing-occluded-windows --disable-back-forward-cache --disable-breakpad --disable-client-side-phishing-detection --disable-component-extensions-with-REDACTED-pages --disable-component-update --no-default-browser-check --disable-default-apps --disable-dev-shm-usage --disable-extensions --disable-features=AvoidUnnecessaryBeforeUnloadCheckSync,BoundaryEventDispatchTracksNodeRemoval,DestroyProfileOnBrowserClose,DialMediaRouteProvider,GlobalMediaControls,HttpsUpgrades,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,Transl tend/node_modules/.bin/astro (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

alistairmatthews · 2026-05-07T15:12:23Z

@copilot This PR does not complete issue #559. Please ensure that, if this PR is merged, #559 is not automatically closed.

Copilot · 2026-05-07T15:15:14Z

@copilot This PR does not complete issue #559. Please ensure that, if this PR is merged, #559 is not automatically closed.

Updated the PR description so it does not contain any auto-closing keywords for #559, so merging this PR will not automatically close that issue. No code/UI changes were made in this update, so there is no screenshot.

Copilot

Pull request overview

Reframes “Getting Started” documentation to use more multi-language-first wording across runtime prerequisites, template guidance, and AppHost architecture explanations.

Changes:

Updates C# prerequisites copy to be more direct and language-first.
Tweaks GitHub Codespaces wording around certificate setup.
Expands template-selection guidance to explicitly mention additional language stacks.
Adjusts AppHost architecture diagrams/wording to refer to “C# API” and changes the Mermaid icon used for the API.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
src/frontend/src/content/docs/get-started/prerequisites.mdx	Rewords C# runtime prerequisite copy for clearer, language-first framing.
src/frontend/src/content/docs/get-started/github-codespaces.mdx	Updates wording describing HTTPS dev certificate setup in Codespaces.
src/frontend/src/content/docs/get-started/aspire-sdk-templates.mdx	Updates template guidance to call out multi-language starter options.
src/frontend/src/content/docs/get-started/app-host.mdx	Updates architecture description to “C# API” and changes Mermaid diagram icon for the API service.

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

    />

-    At this point, the Aspire CLI has been installed and the ASP.NET Core development certificate has been created and trusted inside the Codespace. You can use `aspire new` right away without manually installing `Aspire.ProjectTemplates`.
+    At this point, the Aspire CLI has been installed and the local HTTPS development certificate for .NET apps has been created and trusted inside the Codespace. You can use `aspire new` right away without manually installing `Aspire.ProjectTemplates`.


 ## Create solutions and projects using templates

-To create an Aspire solution or project, use Visual Studio, Visual Studio Code, or the Aspire CLI, and base it on the available templates. Explore additional Aspire templates in the [Aspire samples](https://github.com/microsoft/aspire-samples) repository.
+To create an Aspire solution or project, use Visual Studio, Visual Studio Code, or the Aspire CLI, and base it on the available templates. Choose the template that matches your app stack, including C#, TypeScript, Python, and JavaScript starter options. Explore additional Aspire templates in the [Aspire samples](https://github.com/microsoft/aspire-samples) repository.



  service db(logos:postgresql)[PostgreSQL]
-  service api(logos:dotnet)[API service]
+  service api(logos:c-sharp)[API service]


  service db(logos:postgresql)[pg]
  service epr(iconoir:server-connection)[Endpoint Reference]
-  service api(logos:dotnet)[api]
+  service api(logos:c-sharp)[api]


Initial plan

80cafc2

Copilot AI assigned Copilot and alistairmatthews May 7, 2026

Copilot started work on behalf of alistairmatthews May 7, 2026 13:42 View session

Copilot AI linked an issue May 7, 2026 that may be closed by this pull request

Replace "non-.NET" phrasing across docs #559

Open

Use more inclusive language on generic getting-started docs

4111d76

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/907fb32d-bab4-4c07-9f94-67a069a248c4 Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Replace 'non-.NET' wording across documentation~~ Reframe generic Getting Started docs with multi-language-first wording May 7, 2026

Copilot finished work on behalf of alistairmatthews May 7, 2026 13:59

Copilot AI requested a review from alistairmatthews May 7, 2026 13:59

davidfowl reviewed May 7, 2026

View reviewed changes

alistairmatthews requested changes May 7, 2026

View reviewed changes

Copilot started work on behalf of alistairmatthews May 7, 2026 14:56 View session

Address PR review comments on generic docs wording

763ae9d

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/a6197f20-514c-44e5-9c61-01198699b4dd Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>

Copilot finished work on behalf of alistairmatthews May 7, 2026 15:07

Copilot AI requested a review from alistairmatthews May 7, 2026 15:07

Copilot started work on behalf of alistairmatthews May 7, 2026 15:12 View session

alistairmatthews marked this pull request as ready for review May 7, 2026 15:15

alistairmatthews requested a review from IEvangelist as a code owner May 7, 2026 15:15

Copilot AI review requested due to automatic review settings May 7, 2026 15:15

Copilot finished work on behalf of alistairmatthews May 7, 2026 15:16

Copilot started reviewing on behalf of alistairmatthews May 7, 2026 15:16 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Reframe generic Getting Started docs with multi-language-first wording#877

Reframe generic Getting Started docs with multi-language-first wording#877
Copilot wants to merge 3 commits into
mainfrom
copilot/replace-non-net-phrasing

Copilot AI commented May 7, 2026 •

edited

Loading

Uh oh!

davidfowl May 7, 2026

Uh oh!

Copilot AI May 7, 2026

Uh oh!

alistairmatthews left a comment

Uh oh!

alistairmatthews May 7, 2026

Uh oh!

Copilot AI May 7, 2026

Uh oh!

alistairmatthews May 7, 2026

Uh oh!

Copilot AI May 7, 2026

Uh oh!

Copilot AI commented May 7, 2026 •

edited

Loading

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

alistairmatthews commented May 7, 2026

Uh oh!

Copilot AI commented May 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Copilot AI commented May 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

davidfowl May 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI May 7, 2026

Choose a reason for hiding this comment

Uh oh!

alistairmatthews left a comment

Choose a reason for hiding this comment

Uh oh!

alistairmatthews May 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI May 7, 2026

Choose a reason for hiding this comment

Uh oh!

alistairmatthews May 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI May 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented May 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

alistairmatthews commented May 7, 2026

Uh oh!

Copilot AI commented May 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented May 7, 2026 •

edited

Loading

Copilot AI commented May 7, 2026 •

edited

Loading