Skip to content

Update contribution guide#17530

Merged
davidfowl merged 8 commits into
mainfrom
davidfowl/ai-contribution-guide
May 27, 2026
Merged

Update contribution guide#17530
davidfowl merged 8 commits into
mainfrom
davidfowl/ai-contribution-guide

Conversation

@davidfowl

Copy link
Copy Markdown
Contributor

Description

This updates the contribution guide so contributors have current setup, testing, extension, local build, and AI-assisted contribution guidance in one place.

Summary:

  • Adds a table of contents for the guide.
  • Updates restore and local .NET SDK guidance to match the current global.json behavior.
  • Documents how to build and iterate on the VS Code extension, including localization expectations.
  • Clarifies Dashboard localization, test filters for quarantined and outerloop tests, and package-only validation.
  • Adds guidance for using localhive to create an isolated, fully usable local Aspire build without overwriting the default install.
  • Adds AI-assisted contribution expectations for Copilot automatic reviews and the key code-review and pr-testing skills.
  • Refreshes stale build, package, and feed examples.

Validation: docs-only change; checked the markdown diff for formatting issues.

Fixes # (issue)

Checklist

  • Is this feature complete?
    • Yes. Ready to ship.
    • No. Follow-up changes expected.
  • Are you including unit tests for the changes and scenario tests if relevant?
    • Yes
    • No
  • Did you add public API?
    • Yes
      • If yes, did you have an API Review for it?
        • Yes
        • No
      • Did you add <remarks /> and <code /> elements on your triple slash comments?
        • Yes
        • No
    • No
  • Does the change make any security assumptions or guarantees?
    • Yes
      • If yes, have you done a threat model and had a security review?
        • Yes
        • No
    • No

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 27, 2026 06:22
@github-actions

github-actions Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 17530

Or

  • Run remotely in PowerShell:
iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 17530"

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 docs-only PR refreshes the Aspire contribution guide with current setup, build, testing, localization, extension, local package, localhive, and AI-assisted contribution guidance.

Changes:

  • Adds a table of contents and updated repo setup/build guidance.
  • Documents VS Code extension build/inner-loop and localization expectations.
  • Adds guidance for test filters, package-only validation, localhive, and Aspire PR review/testing skills.
Show a summary per file
File Description
docs/contributing.md Updates the contributor guide with refreshed build/test/localization/extension/localhive/AI guidance.

Copilot's findings

  • Files reviewed: 1/1 changed files
  • Comments generated: 1

Comment thread docs/contributing.md Outdated
davidfowl and others added 7 commits May 26, 2026 23:27
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@davidfowl davidfowl merged commit db5a85a into main May 27, 2026
7 checks passed
@davidfowl davidfowl deleted the davidfowl/ai-contribution-guide branch May 27, 2026 07:20
@microsoft-github-policy-service microsoft-github-policy-service Bot added this to the 13.5 milestone May 27, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor

✅ No documentation update needed.

docs_optional → build_or_ci_only

No triggered signals (signal_count == 0; only_test_or_build_changes: true).

The single changed file — docs/contributing.md — is an internal contributor-facing guide under docs/, within the build_or_ci_only allowlist. It contains no user-facing API surface, CLI flags, configuration keys, or behavior that would need to be reflected on microsoft/aspire.dev. No docs PR is needed.

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.

2 participants