docs: #3578794 Add D11 migration planning docs as a dedicated section

André Angelantonirequested to merge
issue/groupsdrupalorg-3578794:3578794-migration-docs into 1.x

This MR imports the six Drupal 6 → Drupal 11 Groups migration planning documents into the Starlight docs site as a new D11 Migration sidebar section, exposing work that previously lived only in a local working tree.

Pages added (under docs/src/content/docs/migration/)

  • Start Here, Conversion Plan, Architecture Differences, Runbook, Views & Endpoints, Testing Strategy.

Normalization for the docs-site gates

The source docs were GitHub-flavored; to satisfy the site gates I:

  • added title/description frontmatter and dropped the duplicate H1;
  • rewrote cross-links between the six pages to the relative-link convention, and neutralized links to non-imported source files (config/, modules/, scripts/, feature_tour/) so the strict link validator passes;
  • converted GitHub-style alerts to plain bold-label blockquotes and unwrapped list/code/table blockquotes (plus two escaped-pipe table rows) so the content stays Keystatic-editable.

Verification

Local npm run build is green: astro check (0 errors), check:keystatic (Layer 1 round-trip + Layer 2 static), starlight link validation (all internal links valid, 36 pages built), and content-conventions lint. Pre-commit and pre-push hooks passed.

Closes #3578794 (closed).

AI disclosure: Authored with AI assistance (Claude Code); reviewed by a human maintainer before merge.

Merge request reports