Fix markdown formatting to pass CI checks

- README.md: Add language to code blocks, use consistent list numbering
- SECURITY.md: Fix table alignment, add language to code blocks, add
  blank line before fenced code
- MIGRATION-PLAN.md: Fix table alignment, add blank lines around
  headings/lists/code blocks, remove trailing punctuation from headings

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: fergusbisset

MIGRATION-PLAN.md

@@ -4,12 +4,12 @@ This document outlines the step-by-step process to migrate from the original rep
 
 ## Overview
 
-| Item | From | To |
-|------|------|-----|
-| **Repository** | Original repository | `github.com/NHSDigital/fdp-react-design-system` |
-| **Package Name** | `@nhsdigital/fdp-design-system` | `@nhsdigital/fdp-design-system` |
-| **Registry** | GitHub Packages | npm public registry |
-| **Author** | Original author | FDP Product Design Team |
+| Item             | From                            | To                                              |
+| ---------------- | ------------------------------- | ----------------------------------------------- |
+| **Repository**   | Original repository             | `github.com/NHSDigital/fdp-react-design-system` |
+| **Package Name** | `@nhsdigital/fdp-design-system` | `@nhsdigital/fdp-design-system`                 |
+| **Registry**     | GitHub Packages                 | npm public registry                             |
+| **Author**       | Original author                 | FDP Product Design Team                         |
 
 ---
 
@@ -18,24 +18,30 @@ This document outlines the step-by-step process to migrate from the original rep
 The NHSDigital template provides standardized CI/CD, security scanning, and compliance tooling.
 
 ### Step 1.1: Add NHSDigital remote and fetch template
+
 ```bash
 git remote add nhsdigital https://github.com/NHSDigital/fdp-react-design-system.git
 git fetch nhsdigital main
 ```
 
 ### Step 1.2: Merge template (allowing unrelated histories)
+
 ```bash
 git merge nhsdigital/main --allow-unrelated-histories -m "Merge NHSDigital repository template"
 ```
 
 ### Step 1.3: Resolve conflicts
+
 Expected conflicts (template vs existing files):
+
 - `.gitignore` - Merge both (keep our npm/node ignores, add template's report ignores)
 - `README.md` - Keep ours, but adopt template structure where appropriate
 - `.github/` workflows - Keep template's CI/CD structure, adapt for npm
 
 ### Step 1.4: Review and integrate template components
+
 Template provides:
+
 - `.github/workflows/` - CI/CD pipeline stages (commit, test, build, publish, deploy)
 - `.github/actions/` - Security scanning, linting, dependency checks
 - `.github/ISSUE_TEMPLATE/` - Standardized issue templates
@@ -51,25 +57,30 @@ Template provides:
 ## Phase 2: Remove Unnecessary Dependencies
 
 ### Step 2.1: Remove Chromatic
+
 ```bash
 npm uninstall chromatic @chromatic-com/storybook
 ```
 
 Remove from `package.json` scripts:
+
 - `"chromatic": "npx chromatic"`
 - `"chromatic:ci": "npx chromatic --exit-zero-on-changes"`
 - `"chromatic:review": "npx chromatic --auto-accept-changes"`
 
 ### Step 2.2: Remove GSAP
+
 ```bash
 npm uninstall gsap
 ```
 
 Update components to use fallbacks:
+
 - `src/components/Parallax/ParallaxScene.tsx` - Already has native scroll fallback
 - `src/components/ProductRoadmap/ProductRoadmap.tsx` - Already has CSS fallback
 
 Changes needed:
+
 1. Remove GSAP import attempts from both components
 2. Use native scroll/CSS-only implementations
 3. Update component documentation to reflect no GSAP dependency
@@ -78,7 +89,7 @@ Changes needed:
 
 ## Phase 3: Remove Unnecessary Documentation
 
-### Files to DELETE (agent work, tracking, aspirational):
+### Files to DELETE (agent work, tracking, aspirational)
 
 ```bash
 # Burndown/tracking docs
@@ -105,7 +116,8 @@ rm docs/roadmaps/lms-extensions.md
 rm docs/roadmaps/ai-interaction-roadmap.tsx
 ```
 
-### Files to REVIEW (decide based on current relevance):
+### Files to REVIEW (decide based on current relevance)
+
 - `docs/roadmaps/ARCHITECTURE_SSR_NUNJUCKS_MIGRATION.mdx` - Keep architecture info, remove roadmap framing
 - `docs/slot-matrix-stories.md` - Keep if SlotMatrix is active
 
@@ -114,6 +126,7 @@ rm docs/roadmaps/ai-interaction-roadmap.tsx
 ## Phase 4: Remove Unnecessary Functionality
 
 ### Step 4.1: Remove FDP Internal Dashboards
+
 Delete `src/components/FDP/` contents EXCEPT Subnav:
 
 ```bash
@@ -128,6 +141,7 @@ rm src/components/FDP/*.syntheticData.ts
 Update `src/components/FDP/index.ts` to only export Subnav (already the case).
 
 ### Step 4.2: Remove Development/Migration Scripts
+
 Delete scripts that were for one-time migrations:
 
 ```bash
@@ -190,17 +204,21 @@ Update `package.json` to remove corresponding npm scripts.
 ```
 
 ### Step 5.2: Update all internal package references
+
 Search and replace throughout codebase:
+
 - `@nhsdigital/fdp-design-system` → `@nhsdigital/fdp-design-system`
 
 Files to update:
+
 - `README.md` (all import examples)
 - `docs/` (all documentation)
 - `examples/nextjs/` (package.json and imports)
 - `examples/express-njk/` (if applicable)
 - Storybook stories with import examples
 
 ### Step 5.3: Update README.md
+
 - Remove GitHub Packages authentication instructions
 - Add npm public registry installation: `npm install @nhsdigital/fdp-design-system`
 - Update repository URLs
@@ -211,6 +229,7 @@ Files to update:
 ## Phase 6: Update CI/CD for npm Publishing
 
 ### Step 6.1: Adapt NHSDigital workflow for npm
+
 The template provides `.github/workflows/cicd-2-publish.yaml`. Update to:
 
 ```yaml
@@ -238,6 +257,7 @@ jobs:
 ```
 
 ### Step 6.2: Set up npm access
+
 1. Create npm organization account for `@nhsdigital` (if not exists)
 2. Generate npm access token
 3. Add `NPM_TOKEN` secret to GitHub repository
@@ -247,9 +267,11 @@ jobs:
 ## Phase 7: Final Cleanup and Verification
 
 ### Step 7.1: Update CLAUDE.md
+
 Update with new repository info, package name, and commands.
 
 ### Step 7.2: Run full verification
+
 ```bash
 npm run lint
 npm run typecheck
@@ -259,13 +281,15 @@ npm run build:parity
 ```
 
 ### Step 7.3: Test local installation
+
 ```bash
 npm pack
 # In a test project:
 npm install /path/to/nhsdigital-fdp-react-design-system-x.x.x.tgz
 ```
 
 ### Step 7.4: Update git remote and push
+
 ```bash
 git remote set-url origin https://github.com/NHSDigital/fdp-react-design-system.git
 git push -u origin main
@@ -276,16 +300,19 @@ git push -u origin main
 ## Phase 8: Post-Migration Tasks
 
 ### Step 8.1: Archive old repository
+
 - Add deprecation notice to original repository
 - Point users to new repository
 
 ### Step 8.2: First npm publish
+
 ```bash
 npm version 1.0.0  # Or appropriate version for fresh start
 npm publish --access public
 ```
 
 ### Step 8.3: Verify npm installation
+
 ```bash
 npm install @nhsdigital/fdp-design-system
 ```
@@ -307,38 +334,45 @@ After the main migration is stable, extract SPC to its own repository:
 ## Checklist
 
 ### Phase 1: Template Merge
+
 - [x] Add NHSDigital remote
 - [x] Merge template with `--allow-unrelated-histories`
 - [x] Resolve merge conflicts
 - [x] Review and integrate template CI/CD
 
 ### Phase 2: Dependencies
+
 - [x] Remove Chromatic
 - [x] Remove GSAP
 - [x] Update ParallaxScene to use fallback only
 - [x] Update ProductRoadmap to use fallback only
 
 ### Phase 3: Documentation
+
 - [x] Delete 16 identified docs files
 - [x] Review 2 ambiguous files
 
 ### Phase 4: Functionality
+
 - [x] Remove FDP internal dashboards (keep Subnav)
 - [x] Remove ~20 development/migration scripts
 - [x] Update package.json scripts
 
 ### Phase 5: Package Config
+
 - [x] Update package name to `@nhsdigital/fdp-design-system`
 - [x] Update author to "FDP Product Design Team"
 - [x] Update license to MIT
 - [x] Update publishConfig for npm public
 - [x] Search/replace all package references
 
 ### Phase 6: CI/CD
+
 - [x] Configure npm publish workflow
 - [ ] Set up NPM_TOKEN secret (requires manual setup in GitHub)
 
 ### Phase 7: Verification
+
 - [x] Lint passes (`npm run lint`)
 - [x] SSR tests pass (59 test files, 220 tests)
 - [ ] Component tests (pre-existing ResizeObserver mock issues in GanttChart/SPC tests)
@@ -347,6 +381,7 @@ After the main migration is stable, extract SPC to its own repository:
 - [ ] Local pack/install test
 
 ### Phase 8: Go Live
+
 - [ ] Push to NHSDigital repo
 - [ ] Publish to npm
 - [ ] Archive old repo

README.md

@@ -20,21 +20,21 @@ If the npm package is not yet available, you can install from GitHub Packages:
 
 1. Create or edit `.npmrc` in your project root:
 
-```
-@nhsdigital:registry=https://npm.pkg.github.com
-```
+   ```text
+   @nhsdigital:registry=https://npm.pkg.github.com
+   ```
 
-2. Authenticate with GitHub Packages (requires a GitHub PAT with `read:packages` scope):
+1. Authenticate with GitHub Packages (requires a GitHub PAT with `read:packages` scope):
 
-```bash
-npm login --registry=https://npm.pkg.github.com
-```
+   ```bash
+   npm login --registry=https://npm.pkg.github.com
+   ```
 
-3. Install the package:
+1. Install the package:
 
-```bash
-npm install @nhsdigital/fdp-design-system
-```
+   ```bash
+   npm install @nhsdigital/fdp-design-system
+   ```
 
 ## Basic Usage
 

SECURITY.md

@@ -4,9 +4,9 @@
 
 We actively support the following versions of the NHS FDP Design System with security updates:
 
-| Version | Supported          |
-| ------- | ------------------ |
-| 0.0.x (alpha)   | :white_check_mark: |
+| Version       | Supported          |
+| ------------- | ------------------ |
+| 0.0.x (alpha) | :white_check_mark: |
 
 **Note:** This project is currently in alpha. Once we reach v1.0.0, we will maintain the current major version and the previous major version with security updates.
 
@@ -76,7 +76,7 @@ npm install @nhsdigital/fdp-design-system@latest
 
 If you're using components with inline styles or dynamic content, configure your CSP headers appropriately:
 
-```
+```text
 Content-Security-Policy:
   default-src 'self';
   style-src 'self' 'unsafe-inline';
@@ -95,6 +95,7 @@ When using SSR components:
 - Never trust client-provided data in server components
 
 Example:
+
 ```tsx
 // ❌ DON'T: Unsanitized user input
 <Header serviceName={userInput} />