Skip to content

feat(slides): correctness fixes, coverage adds, fit-title polish#39

Merged
codebytes merged 1 commit into
mainfrom
feat/slides-correctness-coverage-polish
May 7, 2026
Merged

feat(slides): correctness fixes, coverage adds, fit-title polish#39
codebytes merged 1 commit into
mainfrom
feat/slides-correctness-coverage-polish

Conversation

@codebytes
Copy link
Copy Markdown
Owner

Summary

Three queued slide PRs (#39 correctness / #40 coverage / #41 polish) merged into a single change to keep the deck self-consistent. All against main, single-author, no demo or color changes.

🔴 Correctness (was queued as #39)

Agent-Ready CLI slide rewritten to match aspire.dev:

  • Setup is aspire agent init, not aspire run.
  • Transport is stdio (aspire agent mcp spawned as a subprocess). The previous slide invented an http://localhost:15889/mcp URL — that doesn't exist for the CLI MCP server.
  • Now distinguishes the CLI MCP server (stdio + skill files) from the Dashboard MCP server (streamable HTTP + API key, exposed via the dashboard top-right MCP button).
  • Officially supported clients per docs: VS Code, Claude Code, GitHub Copilot CLI, OpenCode.
  • Real .vscode/mcp.json shape included.

Sources: aspire.dev/get-started/aspire-mcp-server/, aspire.dev/get-started/ai-coding-agents/.

AppHost Languages slide rescoped:

  • Per aspire.dev/languages-and-runtimes/, only C# and TypeScript are documented AppHost authoring languages today.
  • Removed the Python/Java/Go "experimental" stubs (not on the live docs site).
  • Workload language support is covered separately and accurately via AddProject, AddJavaScriptApp, AddPythonApp, AddDockerfile, AddContainer, AddExecutable. Aspire Type System (ATS) called out as the bridge.

🟡 Coverage (was queued as #40)

New slide: "Standalone Dashboard — No AppHost Required" (between the dashboard and OTEL setup slides). Closes the polyglot adoption gap — any OTLP-emitting app can use the dashboard without an AppHost. Includes mcr.microsoft.com/dotnet/aspire-dashboard:latest docker run + a Node.js OTEL config example.
Sources: aspire.dev/dashboard/standalone-for-{nodejs,python}/.

New slide: "Multi-Language Integrations" (right after AppHost Languages). Explains how the Aspire Type System (ATS) auto-generates a TypeScript SDK from .NET hosting integrations, so integration authors write the integration once in C# and TS callers get fluent typed methods with zero hand-written bindings. Marked preview.
Source: aspire.dev/extensibility/multi-language-integration-authoring/.

🟢 Polish (was queued as #41)

Both themes (light + dark): <!--fit--> titles no longer run literally edge-to-edge. Adds margin-inline: 4% (6% on cover/lead/purple/gradient/invert variants) when the H1 contains the Marp fitting SVG, and drops the bottom border on fit titles. Targets section h1:has(svg[data-marp-fitting="svg"]).

Validation

  • ✅ Marp build (docker, bare template) succeeds.
  • ✅ Playwright audit @ 1280×720 across all 36 slides: zero overflow.

Slides after two inserts:

# Slide
8 Standalone Dashboard (new)
16 AppHost Languages (rewritten)
17 Multi-Language Integrations (new)
21 Agent-Ready CLI (rewritten)

Out of scope

  • No demo slide edits, no new images, no theme color changes.
  • The 60+ CC0 icons in the Spring '26 official deck appendix remain a future PR.

.gitignore

Adds slides/out/, slides/audit-slides.cjs, slides/package*.json so future audit/build artifacts stay out of PR diffs.

Three queued slide PRs (#39 correctness, #40 coverage, #41 polish) merged
into a single change to keep the deck self-consistent.

Correctness (PR #39 scope)
==========================
- Slide "Agent-Ready CLI" rewritten to match aspire.dev:
  * Setup is `aspire agent init` (not `aspire run`).
  * Transport is stdio (`aspire agent mcp` spawned as subprocess);
    the `http://localhost:15889/mcp` URL the prior version invented
    does not exist for the CLI MCP server.
  * Distinguishes the CLI MCP server (stdio + skill files) from the
    Dashboard MCP server (streamable HTTP + API key, exposed via the
    dashboard top-right MCP button).
  * Officially supported clients per docs: VS Code, Claude Code,
    GitHub Copilot CLI, OpenCode.
  * Real `.vscode/mcp.json` shape included.
- Slide "AppHost Languages" rescoped to match aspire.dev/languages-and-runtimes:
  only C# and TypeScript are documented AppHost authoring languages today.
  Removed the Python/Java/Go "experimental" stubs (not on the live docs
  site). Workload language support covered separately and accurately
  via `AddProject`, `AddJavaScriptApp`, `AddPythonApp`, `AddDockerfile`,
  `AddContainer`, `AddExecutable`. Aspire Type System (ATS) called out.

Coverage (PR #40 scope)
=======================
- New slide "Standalone Dashboard — No AppHost Required" between the
  dashboard and OTEL setup slides. Closes the polyglot adoption gap:
  any OTLP-emitting app can use the dashboard without an AppHost.
  Includes the `mcr.microsoft.com/dotnet/aspire-dashboard:latest`
  docker run command and a Node.js OTEL config example.
  Source: aspire.dev/dashboard/standalone-for-{nodejs,python}/
- New slide "Multi-Language Integrations" right after AppHost Languages.
  Explains how the Aspire Type System (ATS) auto-generates a TypeScript
  SDK from .NET hosting integrations, so integration authors write
  the integration once in C# and TS callers get fluent typed methods
  with zero hand-written bindings. Marks the feature as preview.
  Source: aspire.dev/extensibility/multi-language-integration-authoring/

Polish (PR #41 scope)
=====================
- Both themes: `<!--fit-->` titles no longer run literally edge-to-edge.
  Adds `margin-inline: 4%` (or 6% on cover/lead/purple/gradient/invert
  variants) when the H1 contains the Marp fitting SVG, and drops the
  bottom border on fit titles. Targets `section h1:has(svg[data-marp-fitting="svg"])`.

Validation
==========
- Marp build (docker, bare template) succeeds.
- Playwright audit @ 1280x720 across all 36 slides: 0 overflow.
  Slides reordered as expected after two inserts:
    8  Standalone Dashboard (new)
    16 AppHost Languages (rewritten)
    17 Multi-Language Integrations (new)
    21 Agent-Ready CLI (rewritten)

Out of scope
============
- No demo slide edits, no new images, no theme color changes.
- The 60+ CC0 icons in the official Spring '26 deck appendix
  remain a future PR.

.gitignore
==========
- Adds slides/out/, slides/audit-slides.cjs, slides/package*.json
  so future audit/build artifacts don't show up in PR diffs.
@codebytes codebytes merged commit 2db92f3 into main May 7, 2026
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.

1 participant