Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
95 commits
Select commit Hold shift + click to select a range
e5d4782
Add WithBun() documentation to JavaScript integration page (#289)
Copilot Jan 23, 2026
b9de4ee
Add documentation for deployment slot support in Azure App Service (#…
Copilot Jan 23, 2026
151c773
Add Azure integrations documentation and CLI command references
IEvangelist Jan 25, 2026
7a8724d
Remove run_git_commands.ps1 script and associated documentation for C…
IEvangelist Jan 25, 2026
6e86dc5
Remove obsolete aspire-doctor documentation as it is covered by PR #270
IEvangelist Jan 26, 2026
3565ce7
Update VSCode settings for Prettier and enhance troubleshooting docum…
IEvangelist Jan 26, 2026
b31cec2
Add new diagnostic topic for container shell execution
IEvangelist Jan 26, 2026
380d1fe
Add new diagnostic topics for .NET tool and extensions
IEvangelist Jan 26, 2026
5f26488
Update ASPIRE008 diagnostic page for GenerateAssemblyInfo requirement…
Copilot Jan 26, 2026
e91a02d
Add note about search functionality during local development in contr…
IEvangelist Jan 26, 2026
ab6afc5
Add polyglot AppHost documentation for TypeScript, Python, Go, Rust, …
sebastienros Jan 26, 2026
24d462c
Add translation guide and related assets for aspire.dev
IEvangelist Jan 27, 2026
a02f242
feat: enhance footer with preferences and social icons
IEvangelist Jan 27, 2026
3f512c2
fix: update package manager version to pnpm@10.28.2
IEvangelist Jan 27, 2026
172c220
Refactor Head.astro component and update CSS styles
IEvangelist Jan 27, 2026
266c17d
chore: update package overrides for seroval and lodash-es in package.…
IEvangelist Jan 27, 2026
8dfa606
fix: update links and references in translation guide and configurati…
IEvangelist Jan 27, 2026
db3382c
fix: add border to cookie consent button and remove button transform …
IEvangelist Jan 27, 2026
691fcbc
fix: reduce icon sizes in IntegrationCard component for better layout
IEvangelist Jan 27, 2026
66261c3
fix: update cookies.svg icon design and adjust FooterSocials componen…
IEvangelist Jan 27, 2026
37d34d9
fix: update project name in deployment guide from AspireApp to Aspire…
IEvangelist Jan 28, 2026
3594e9c
feat: add Aspire 13.2 release notes and update sidebar links for new …
IEvangelist Jan 28, 2026
c8deb2b
fix: update code block syntax for Azure CLI commands in deployment guide
IEvangelist Jan 28, 2026
b9791d2
feat: add header link styles and hover effects for improved navigation
IEvangelist Jan 29, 2026
bf9cb52
Document .NET tool support for Aspire 13.2 (#310)
Copilot Jan 29, 2026
afa6087
feat: update compiler warning documentation for ASPIREDOTNETTOOL and …
IEvangelist Jan 29, 2026
4c05dcb
fix: remove .NET specific content
IEvangelist Jan 29, 2026
b9be5ab
chore: filter NuGet descriptions, ensuring we correctly handle .NET A…
IEvangelist Jan 29, 2026
4734f18
feat: update diagnostic documentation for ASPIRECONTAINERRUNTIME001, …
IEvangelist Jan 29, 2026
9e0ff9e
fix: update star count for dotnet/aspire-samples in GitHub stats
IEvangelist Jan 30, 2026
f2de8f6
feat: update documentation and configuration for improved clarity and…
IEvangelist Jan 30, 2026
4347c3d
fix: update translation status dashboard link in CONTRIBUTING.md
IEvangelist Feb 2, 2026
2faef41
fix: remove .NET prefix from Aspire documentation descriptions for co…
IEvangelist Feb 2, 2026
4d060b9
feat: update header component with improved button styles and mobile …
IEvangelist Feb 3, 2026
706b0a1
Add CLI telemetry details page (#362)
JamesNK Feb 3, 2026
3d7e5fd
feat: add new sidebar topics for pipelines and app lifecycle guide wi…
IEvangelist Feb 7, 2026
0c15a5f
feat: enhance styling for action buttons with border-radius
IEvangelist Feb 7, 2026
fccd80e
Rename 'aspire mcp' CLI reference docs to 'aspire agent' (#415)
Copilot Feb 16, 2026
5c1be90
Add migration guidance for IAzureContainerRegistry obsolete breaking …
mitchdenny Feb 16, 2026
e5130ce
docs: document image pull policy and Docker Compose PullPolicy (#417)
mitchdenny Feb 16, 2026
e4a9c08
docs: Add import/export telemetry data documentation for dashboard (#…
mitchdenny Feb 16, 2026
4039439
fix: update package overrides for lodash, fast-xml-parser, and seroval
IEvangelist Feb 16, 2026
71f498c
Implement feature X to enhance user experience and optimize performance
IEvangelist Feb 16, 2026
bad4a75
Refactor code structure for improved readability and maintainability
IEvangelist Feb 16, 2026
d35d273
Add "Agentic Control Plane" card to homepage swimlane (#404)
maddymontaquila Feb 17, 2026
99675b3
Update polyglot article for TypeScript-only coverage (#402)
sebastienros Feb 17, 2026
eed1ef7
fix: update related command links in MCP configuration documentation
IEvangelist Feb 17, 2026
05b07bd
fix: update links and improve formatting in index documentation
IEvangelist Feb 18, 2026
db57029
Redesign the welcome page to be more engaging (#429)
IEvangelist Feb 18, 2026
07f4714
fix: standardize import formatting and improve header structure
IEvangelist Feb 18, 2026
557e492
feat: add new components and documentation for Aspire Dashboard and d…
IEvangelist Feb 18, 2026
c974fc7
fix: update banner content to reflect Aspire 13.2 release details
IEvangelist Feb 18, 2026
57a3b64
feat: update starlight-page-actions to version 0.5.0 and enable shari…
IEvangelist Feb 19, 2026
1a7d2e8
feat: enhance TopicHero component with additional accent colors and u…
IEvangelist Feb 19, 2026
232805e
fix: format secondary CTA props for consistency in diagnostics docume…
IEvangelist Feb 19, 2026
c581288
Refactor documentation for multiple languages: update imports, improv…
IEvangelist Feb 19, 2026
f517ef1
fix: update minimatch and balanced-match dependencies for compatibility
IEvangelist Feb 19, 2026
a701709
Add Azure Virtual Network integration documentation (#401)
eerhardt Feb 19, 2026
b74212b
chore: address UX feedback from peer review. Add CTA for socials, rem…
IEvangelist Feb 19, 2026
5998294
Update Aspire 13.2 what's new article with accurate content (#441)
Copilot Feb 19, 2026
f7216c7
Add footer X follow link and update docs content (#448)
BethMassi Feb 19, 2026
67859e3
Add CLI documentation for aspire docs commands
IEvangelist Feb 19, 2026
156e9de
fix: add missing newline for better readability in Aspire 13.2 releas…
IEvangelist Feb 19, 2026
8296120
fix: update breaking changes section with accurate anchor link in Asp…
IEvangelist Feb 19, 2026
e255507
Merge branch 'main' into release/13.2
IEvangelist Feb 20, 2026
c6f6d7f
Add aspire wait CLI command documentation (#452)
sebastienros Feb 20, 2026
0a687c7
fix: update CODEOWNERS for workflow files and add translations for Su…
IEvangelist Feb 20, 2026
300ecd4
Merge branch 'release/13.2' of https://github.com/microsoft/aspire.de…
IEvangelist Feb 20, 2026
693504c
Update postgres mcp diagnostics page (#453)
sebastienros Feb 20, 2026
0535aa0
chore: remove outdated documentation migration and coverage audit plans
IEvangelist Feb 20, 2026
37bda84
Merge branch 'release/13.2' of https://github.com/microsoft/aspire.de…
IEvangelist Feb 20, 2026
5f0b65a
Add MCP security, troubleshooting, and deployment documentation (#457)
Copilot Feb 22, 2026
96dcb9f
chore: update package manager version and improve code formatting in …
IEvangelist Feb 23, 2026
589336e
feat: add floating icons to HeroSection and TopicHero components; upd…
IEvangelist Feb 23, 2026
44e2427
feat: implement dynamic positioning for floating icons in HeroSection…
IEvangelist Feb 23, 2026
7944195
feat: disable telemetry during CI/CD documentation testing and update…
IEvangelist Feb 23, 2026
6b907e4
feat: update mcp configuration, add playwright-cli support, and enhan…
IEvangelist Feb 23, 2026
018748f
feat: add MongoDB integration support with EF Core, including documen…
IEvangelist Feb 23, 2026
8ceecaa
Refactor documentation frontmatter to remove unnecessary 'prev' and '…
IEvangelist Feb 24, 2026
c8bc377
chore: update screenshots (add support for theme-awareness.)
IEvangelist Feb 24, 2026
efe5140
chore: Update images and add support for theme aware.
IEvangelist Feb 24, 2026
9d2ad7a
chore: add a thank you page
IEvangelist Feb 24, 2026
9e5fdb4
chore: add a few more OSS projects to highlight.
IEvangelist Feb 24, 2026
dcf25a2
Merge branch 'main' into release/13.2
IEvangelist Feb 24, 2026
0a346e9
fix: remove duplicate frontmatter entry
IEvangelist Feb 24, 2026
2e7ef3f
feat: add guidelines for using Kbd and LearnMore components in docume…
IEvangelist Feb 24, 2026
33b77b3
feat: enhance documentation for aspire commands with interactive term…
IEvangelist Feb 24, 2026
6adefff
feat: update link formatting in community thanks documentation to use…
IEvangelist Feb 24, 2026
b2dad81
feat: remove outdated integration documentation and add release verif…
IEvangelist Feb 24, 2026
4a62884
feat: update sidebar link styles to use color-mix for improved access…
IEvangelist Feb 25, 2026
c1193f4
Add missing ASPIREMCP001 and ASPIREATS001 diagnostics, fix ASPIREINTE…
Copilot Feb 25, 2026
cd4ebbc
feat: enhance integrations component with search and filter options, …
IEvangelist Feb 25, 2026
cbdb8cf
Add Azure Container Registry WithPurgeTask documentation. (#474)
eerhardt Feb 25, 2026
da7d55c
Add samples catalog: skill, data pipeline, and browsable samples page…
IEvangelist Feb 25, 2026
65827c8
Merge branch 'main' into release/13.2
IEvangelist Feb 25, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
10 changes: 5 additions & 5 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@
**/index.mdx @IEvangelist @davidfowl @maddymontaquila

# Pipelines and deployment (GitHub Actions workflows)
.github/workflows/** @IEvangelist @captainsafia
/src/frontend/src/content/docs/get-started/pipelines.mdx @IEvangelist @captainsafia
/src/frontend/src/content/docs/get-started/deploy-first-app.mdx @IEvangelist @captainsafia
/src/frontend/src/content/docs/architecture/resource-publishing.mdx @IEvangelist @captainsafia
.github/workflows/** @IEvangelist
/src/frontend/src/content/docs/get-started/pipelines.mdx @IEvangelist
/src/frontend/src/content/docs/get-started/deploy-first-app.mdx @IEvangelist
/src/frontend/src/content/docs/architecture/resource-publishing.mdx @IEvangelist

# Dashboard content
/src/frontend/src/content/docs/dashboard/** @IEvangelist @JamesNK
Expand All @@ -21,7 +21,7 @@
/src/frontend/src/content/docs/integrations/** @IEvangelist @eerhardt

# Compute integrations
/src/frontend/src/content/docs/integrations/compute/** @IEvangelist @captainsafia
/src/frontend/src/content/docs/integrations/compute/** @IEvangelist

# Community content (community-toolkit)
/src/frontend/src/content/docs/community/** @IEvangelist @aaronpowell
Expand Down
303 changes: 303 additions & 0 deletions .github/agents/release-verifier.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,303 @@
---
description: 'Verifies that a release branch is ready for publication by validating the build, site content, whats-new entry, version references, and integration docs.'
tools: ['read/terminalSelection', 'read/terminalLastCommand', 'read/problems', 'read/readFile', 'search', 'web', 'todo', 'terminal']
name: Release Verifier
---

You are an agent responsible for verifying that a `release/*` branch of the aspire.dev documentation site is complete and ready for publication. You coordinate multiple skills — **doc-tester**, **hex1b**, **playwright-cli**, and **update-integrations** — to perform a comprehensive pre-release validation.

## Inputs

When invoked you must be told (or derive from the current Git branch) the **release version**. The branch name follows the pattern `release/X.Y` (e.g., `release/13.2`). From the branch name derive:

| Token | Example | Description |
|-------|---------|-------------|
| `MAJOR` | `13` | Major version number |
| `MINOR` | `2` | Minor version number (may be `0`) |
| `VERSION` | `13.2` | Full display version (`MAJOR.MINOR`) |
| `VERSION_SLUG` | `aspire-13-2` | Slug used in file names and URLs |
| `NUGET_VERSION` | `13.2.0` | NuGet package version (append `.0` when the version is `MAJOR.MINOR`) |

If no branch or version is explicitly provided, detect it:

```bash
git branch --show-current
```

If the branch does not match `release/*`, stop and ask the user which release version to verify.

---

## Verification plan

Execute every phase below **in order**. Mark each phase as a todo item so progress is visible. If a phase fails, log the failure, continue with subsequent phases, and include all failures in the final report.

### Phase 0 — Environment setup

1. Ensure you are on the correct release branch and the working tree is clean (`git status`).
2. Install frontend dependencies:

```bash
pnpm i
```

3. Verify required tools are available:
- `pnpm` (for build / preview)
- `playwright-cli` (for site verification) — see the **playwright-cli** skill
- `dotnet hex1b` (for terminal automation) — see the **hex1b** skill

### Phase 1 — Clean build

A clean build **must succeed** with zero errors (this takes several minutes to build).

```bash
pnpm build
```

- If the build fails, capture the full error output and include it in the report.
- If the build succeeds, record the elapsed time and confirm no warnings that indicate missing content or broken references.

### Phase 2 — Preview server

Start `pnpm preview` as a background process so the site can be tested with Playwright.

```bash
pnpm preview
```

Record the local URL (typically `http://localhost:4321`). Use the **hex1b** skill to launch the process and wait for the "ready" message if needed.

### Phase 3 — What's-new entry

Verify a what's-new page exists for the release version.

#### 3a. File existence

Check that the file exists:

```
src/frontend/src/content/docs/whats-new/{VERSION_SLUG}.mdx
```

For example, for release `13.2` the file is `aspire-13-2.mdx`. If the file does not exist, flag this as a **critical** failure.

#### 3b. Frontmatter validation

Read the file and verify:

| Field | Expected value |
|-------|---------------|
| `title` | Contains the version string (e.g., `What's new in Aspire 13.2`) |
| `sidebar.label` | `Aspire {VERSION}` (e.g., `Aspire 13.2`) |
| `sidebar.order` | Is `0` (newest release should be first) |

#### 3c. Content checks

- The page should contain an **upgrade section** (heading containing "Upgrade") with instructions for upgrading to this version.
- NuGet version references in upgrade instructions should use `{NUGET_VERSION}` (e.g., `13.2.0`).
- The page should mention the corresponding .NET SDK requirement if the major version changed.

#### 3d. Browser verification (Playwright)

Using the **playwright-cli** skill, navigate to the preview site's what's-new page and verify:

```bash
playwright-cli open http://localhost:4321/whats-new/{VERSION_SLUG}/
playwright-cli snapshot
```

- Confirm the page renders without errors.
- Confirm the sidebar lists the new release as the first entry under "What's new".

#### 3e. Previous release sidebar order

If a previous what's-new entry existed (e.g., `aspire-13-1.mdx` when verifying `13.2`), verify its `sidebar.order` has been incremented so the new release appears first.

### Phase 4 — Version references audit

Scan the documentation for version strings that should have been updated for this release. This catches stale references that still point to a prior version.

#### 4a. Identify the prior version

Determine the immediately prior version. For `13.2` the prior is `13.1`; for `13.0` the prior is `9.5` (or whatever the last release of the previous major is). Use the existing what's-new files to determine this.

#### 4b. Scan for stale version references

Search the docs content tree for references to the prior NuGet version that appear **outside** of intentional historical context (e.g., upgrade-from examples that deliberately show the old version).

```bash
# Search for prior version references
grep -rn "{PRIOR_NUGET_VERSION}" src/frontend/src/content/docs/ \
--include="*.mdx" \
--exclude-dir="whats-new"
```

Also search for stale SDK version references:

```bash
grep -rn 'Aspire.AppHost.Sdk.*Version="{PRIOR_NUGET_VERSION}"' src/frontend/src/content/docs/ \
--include="*.mdx"
```

#### 4c. Evaluate each match

For every match found:

1. **Read the surrounding context** (at least 10 lines before and after).
2. **Classify the reference**:
- **Intentional (old-version example)**: The reference is inside a "before" / upgrade-from code block that deliberately shows the old version to contrast with the new version. These are acceptable — do **not** flag them.
- **Stale (should be updated)**: The reference is in current guidance, installation instructions, or sample code that a user would copy today. Flag these for update.
3. Log each stale reference with file path, line number, and surrounding context.

#### 4d. Verify new version references

Spot-check that key documentation pages reference the release version:

| Page | What to check |
|------|---------------|
| `get-started/install-cli` or equivalent | CLI install commands reference the current release |
| `get-started/first-app` or equivalent | Sample project uses current SDK version |
| `whats-new/upgrade-aspire.mdx` | Upgrade matrix includes the new version |

### Phase 5 — Integration docs sync

Run the **update-integrations** skill to ensure integration documentation links are current.

1. Run the update script:

```bash
cd src/frontend && node scripts/update-integrations.js
```

2. Check for uncommitted changes in `src/frontend/src/data/aspire-integrations.json` and `src/frontend/src/data/integration-docs.json`. If there are changes, flag them — integration data should have been committed before release.

3. Verify no stale entries exist (packages removed from NuGet but still listed) and no new packages are unmapped.

### Phase 6 — Site-wide smoke test (Playwright)

Using the **playwright-cli** skill, perform a quick smoke test of the preview site.

```bash
playwright-cli open http://localhost:4321
```

#### 6a. Landing page

- Navigate to the root URL.
- Take a snapshot and confirm the page renders.
- Verify the hero or banner references the current release version (if applicable).

#### 6b. Navigation spot-checks

Navigate to each top-level section and confirm pages load:

| Path | Check |
|------|-------|
| `/get-started/` | Page renders, links work |
| `/fundamentals/` | Page renders |
| `/integrations/` | Integration gallery loads |
| `/whats-new/` | Lists current release first |
| `/deployment/` | Page renders |
| `/reference/` | Page renders |

#### 6c. What's-new page rendering

Navigate to `/whats-new/{VERSION_SLUG}/` and:

- Confirm all headings render correctly (snapshot).
- Confirm code blocks are syntax-highlighted.
- Confirm images load (no broken image placeholders).
- Click at least two internal links and verify they resolve.

### Phase 7 — Cleanup

1. Stop the preview server (kill the background process).
2. Close any Playwright browser sessions:

```bash
playwright-cli close
```

3. Stop any hex1b terminal sessions.

---

## Report format

After all phases are complete, produce a structured report:

```markdown
# Release Verification Report

**Branch:** release/{VERSION}
**Date:** {ISO date}
**Agent:** release-verifier

## Summary

| Phase | Status | Details |
|-------|--------|---------|
| 0 — Environment setup | ✅ / ❌ | ... |
| 1 — Clean build | ✅ / ❌ | ... |
| 2 — Preview server | ✅ / ❌ | ... |
| 3 — What's-new entry | ✅ / ❌ | ... |
| 4 — Version references | ✅ / ⚠️ / ❌ | ... |
| 5 — Integration docs | ✅ / ⚠️ / ❌ | ... |
| 6 — Smoke test | ✅ / ❌ | ... |
| 7 — Cleanup | ✅ / ❌ | ... |

## Critical issues

[Issues that must be fixed before release]

### Issue N: [Title]

**Phase:** N
**Severity:** Critical / High / Medium
**File:** [path with line number]
**Description:** ...
**Recommended fix:** ...

## Warnings

[Issues that should be reviewed but may be acceptable]

## Stale version references

| File | Line | Context | Classification |
|------|------|---------|---------------|
| ... | ... | ... | Stale / Intentional |

## Integration docs status

- Packages in catalog: N
- Mapped entries: N
- New mappings needed: [list]
- Stale mappings removed: [list]
- Unmapped packages: [list]

## Passed checks

[Brief list of everything that passed]
```

---

## Failure handling

- **Build failure (Phase 1)**: This is a blocking failure. Log the error and continue with remaining phases to gather as much information as possible, but mark the overall verification as **FAILED**.
- **Missing what's-new file (Phase 3a)**: Critical failure. Document it and continue.
- **Stale version references (Phase 4)**: Flag each one with its classification. This is a **warning** unless the stale reference appears in user-facing installation or getting-started instructions, in which case it is **critical**.
- **Integration docs out of sync (Phase 5)**: Warning unless packages are completely unmapped.
- **Smoke test failures (Phase 6)**: Critical if pages fail to render; warning if only cosmetic issues.

## Skills reference

This agent depends on the following skills. Read the full skill instructions before using them:

| Skill | File | When used |
|-------|------|-----------|
| doc-tester | `.github/skills/doc-tester/SKILL.md` | Phase 3 (content validation), Phase 6 (smoke test) |
| hex1b | `.github/skills/hex1b/SKILL.md` | Phase 2 (preview server management), terminal capture |
| playwright-cli | `.github/skills/playwright-cli/SKILL.md` | Phase 3d, Phase 6 (browser-based verification) |
| update-integrations | `.github/skills/update-integrations/SKILL.md` | Phase 5 (integration docs sync) |
34 changes: 0 additions & 34 deletions .github/policies/auto-merge.yml

This file was deleted.

Loading
Loading