Skip to content

Add developer certificate setup guide and install-flow cross-links#1164

Open
IEvangelist with Copilot wants to merge 2 commits into
mainfrom
copilot/add-dev-certs-documentation
Open

Add developer certificate setup guide and install-flow cross-links#1164
IEvangelist with Copilot wants to merge 2 commits into
mainfrom
copilot/add-dev-certs-documentation

Conversation

Copilot AI commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

This PR adds a dedicated Aspire docs page for development certificate setup and links it from install/get-started flows. It covers the new CLI trust behavior for polyglot apps (aspire run/aspire start) and the .NET-specific dotnet dev-certs path.

  • New get-started documentation

    • Added /get-started/developer-certificates/ with:
      • CLI-managed trust via aspire run and aspire start
      • explicit cert lifecycle commands (aspire certs trust, aspire certs clean)
      • .NET-specific dotnet dev-certs https --trust / --clean guidance
      • troubleshooting pointers and links to deeper certificate docs
  • Install-flow cross-links

    • Updated get-started/install-cli.mdx to include the new page in See also
    • Updated get-started/aspire-sdk-templates.mdx cert guidance to point to the new consolidated page
  • Redirect follow-up

    • Maintainer follow-up requested: register https://aka.ms/aspire/devcerts to redirect to /get-started/developer-certificates/
# CLI-managed trust (recommended)
aspire run
aspire start

# Explicit trust/refresh
aspire certs trust
aspire certs clean
aspire certs trust

# .NET-specific path
dotnet dev-certs https --trust

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Add aka.ms link and documentation for developer certificates Add developer certificate setup guide and install-flow cross-links Jun 2, 2026
Copilot AI requested a review from IEvangelist June 2, 2026 02:56
@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

Adds a new “Set up development certificates” get-started page and wires it into existing onboarding flows so readers can find certificate trust/setup guidance from install and template docs.

Changes:

  • Added a new /get-started/developer-certificates/ documentation page covering Aspire CLI certificate trust commands and the dotnet dev-certs workflow.
  • Linked the new page from the CLI install page “See also” section.
  • Updated the SDK templates get-started doc to point to the consolidated certificate guidance page.

Reviewed changes

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

File Description
src/frontend/src/content/docs/get-started/install-cli.mdx Adds a “See also” link to the new developer certificates page.
src/frontend/src/content/docs/get-started/developer-certificates.mdx Introduces the new consolidated developer certificates setup guide.
src/frontend/src/content/docs/get-started/aspire-sdk-templates.mdx Replaces external certificate troubleshooting links with a pointer to the new consolidated page.

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

Comment on lines +15 to +19
When you run either of these commands, Aspire ensures a development certificate exists and is trusted:

```bash title="Aspire CLI"
aspire run
```
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.

[13.2] Add a new aka.ms link and documentation on setup of developer certificates

3 participants