Skip to content

feat(docs): implement 10 Astro feature items from PAO audit#524

Merged
bradygaster merged 1 commit intobradygaster:devfrom
diberry:squad/astro-features
Mar 23, 2026
Merged

feat(docs): implement 10 Astro feature items from PAO audit#524
bradygaster merged 1 commit intobradygaster:devfrom
diberry:squad/astro-features

Conversation

@diberry
Copy link
Copy Markdown
Collaborator

@diberry diberry commented Mar 22, 2026

Summary

Implements all 10 items from PAO's docs site audit. ALL changes are inside docs/.

Working as EECOM (Core Dev)

Changes

  1. @astrojs/sitemap - Installed, integrated, sitemap-index.xml generated on build
  2. Code block copy button - Global JS in BaseLayout, clipboard API, Tailwind styled
  3. Twitter Card - Changed to summary_large_image in BaseLayout
  4. Edit this page link - GitHub edit URL in DocsLayout footer
  5. robots.txt - Created docs/public/robots.txt with Allow: / and Sitemap reference
  6. Table of Contents - TableOfContents.astro client-side component, right column on wide screens
  7. @astrojs/rss - Installed, src/pages/rss.xml.js endpoint from blog collection
  8. Next/Prev navigation - Computed from NAV_SECTIONS in [...slug].astro, rendered in DocsLayout
  9. Richer frontmatter - Added tags, author, updatedAt, status to docs + blog schemas; updatedAt displayed in DocsLayout
  10. View Transitions - ViewTransitions component in BaseLayout head

Tests

docs/tests/astro-features.test.mjs - 19/19 pass
Existing build-output.test.mjs - 13/13 pass

Build: astro build succeeded, 138 pages + sitemap-index.xml + rss.xml generated.

@bradygaster - tagging you for review. Requested by Dina.

1. @astrojs/sitemap — add integration, sitemap-index.xml generated on build
2. Code block copy button — global JS in BaseLayout, clipboard API, Tailwind styled
3. Twitter Card — change to summary_large_image in BaseLayout
4. Edit this page — GitHub edit link in DocsLayout footer
5. robots.txt — create docs/public/robots.txt with Allow: /, Sitemap ref
6. Table of Contents — TableOfContents.astro client-side component, right column in DocsLayout
7. @astrojs/rss — install package, create src/pages/rss.xml.js from blog collection
8. Next/Prev navigation — compute from NAV_SECTIONS in [...slug].astro, render in DocsLayout
9. Richer frontmatter — add tags, author, updatedAt, status to docs + blog schemas; display updatedAt in DocsLayout
10. View Transitions — import ViewTransitions from astro:transitions in BaseLayout

Tests: docs/tests/astro-features.test.mjs — 19/19 pass (source + build-output checks)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@diberry
Copy link
Copy Markdown
Collaborator Author

diberry commented Mar 22, 2026

@bradygaster - all 10 PAO audit items implemented and tested. 19/19 new tests pass, 13/13 existing tests still green. Build clean at 138 pages. Ready for review.

@bradygaster bradygaster merged commit cbd07a3 into bradygaster:dev Mar 23, 2026
0 of 2 checks passed
chrislomonico pushed a commit to clomonico/squad that referenced this pull request Mar 26, 2026
…r#546)

Consolidated 15 remaining issues into a single PR. Redesigns help UX with grouped categories, surfaces all /help commands, aligns docs with actual CLI behavior, adds first-run welcome, standardizes naming.

Closes bradygaster#510, Closes bradygaster#513, Closes bradygaster#514, Closes bradygaster#515, Closes bradygaster#516, Closes bradygaster#517, Closes bradygaster#518, Closes bradygaster#521, Closes bradygaster#522, Closes bradygaster#523, Closes bradygaster#524, Closes bradygaster#525, Closes bradygaster#527, Closes bradygaster#528, Closes bradygaster#529

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

3 participants