From 938222684fc8f58891a458efe5d20a13c6b404fc Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 13 Nov 2025 08:12:16 -0600 Subject: [PATCH 1/2] port: Create a migration plan/prompt. And start initial port. --- .github/prompts/migrate-from-learn.prompt.md | 161 +++++ src/frontend/sidebar.topics.ts | 88 +++ .../src/assets/testing/testing-diagram.png | Bin 0 -> 575484 bytes .../content/docs/testing/manage-app-host.mdx | 219 ++++++ .../src/content/docs/testing/overview.mdx | 74 ++ .../docs/testing/write-your-first-test.mdx | 649 ++++++++++++++++++ 6 files changed, 1191 insertions(+) create mode 100644 .github/prompts/migrate-from-learn.prompt.md create mode 100644 src/frontend/src/assets/testing/testing-diagram.png create mode 100644 src/frontend/src/content/docs/testing/manage-app-host.mdx create mode 100644 src/frontend/src/content/docs/testing/overview.mdx create mode 100644 src/frontend/src/content/docs/testing/write-your-first-test.mdx diff --git a/.github/prompts/migrate-from-learn.prompt.md b/.github/prompts/migrate-from-learn.prompt.md new file mode 100644 index 00000000..da67f278 --- /dev/null +++ b/.github/prompts/migrate-from-learn.prompt.md @@ -0,0 +1,161 @@ +# Documentation Migration Plan: docs-aspire to aspire.dev + +## Overview + +Migrate documentation content from the legacy `E:\GitHub\docs-aspire` repository to the new `aspire.dev` site, transforming content from docfx/Microsoft Learn format to Astro/Starlight format. + +## Source Repository Details + +- **Location**: `E:\GitHub\docs-aspire` +- **Format**: YAML frontmatter + Markdown (`.md`) +- **Build system**: docfx (Microsoft Learn) +- **Structure**: Uses snippet directories for code samples +- **Target platform**: Microsoft Learn documentation + +## Target Repository Details + +- **Location**: Current workspace (`E:\GitHub\aspire.dev`) +- **Format**: Frontmatter + MDX (`.mdx`) +- **Build system**: Astro + Starlight +- **Structure**: Inline code samples, custom components +- **Target platform**: aspire.dev website + +## Key Differences & Transformations + +### Format Changes +- **File extension**: `.md` → `.mdx` +- **Code samples**: External snippets → Inline code blocks +- **Frontmatter**: YAML structure differences (need to map fields) +- **Components**: Microsoft Learn includes → Astro/Starlight components +- **Images**: Copy from `docs-aspire/docs/{section}/media/` to `aspire.dev/src/frontend/src/assets/{section}/` +- **Excalidraw sources**: Always copy `.excalidraw` files along with image exports + +### Frontmatter Transformation +- **Remove**: `ms.date`, `ms.topic`, `ms.custom`, and other Microsoft Learn-specific metadata +- **Keep**: `title`, `description` +- **Add if needed**: `tableOfContents`, `lastUpdated` +- **Simplify titles**: Remove redundant "Aspire" prefix when appropriate (e.g., "Aspire testing overview" → "Testing overview") + +### Component Mapping +- **Admonitions**: `> [!NOTE]` → `