Skip to content

📝 docs: sync package READMEs into docs site - #111

Merged
vtempest merged 1 commit into
masterfrom
claude/brave-hamilton-1xxe0l
Sep 28, 2026
Merged

vtempest merged 1 commit into
masterfrom
claude/brave-hamilton-1xxe0l

Conversation

@vtempest

Copy link
Copy Markdown
Collaborator

Syncs package README files into the documentation site as MDX pages, with auto-discovery of new packages and CI automation.

Changes

  • New documentation pages: Added MDX pages for test-google-login and legal-terms-privacy-policy packages, synced from their README files
  • Auto-discovery system: Enhanced sync-readme-docs.ts to automatically discover and sync any packages/*/README.md not in the curated list, placing undocumented packages under an "Other" category with a default icon
  • CI automation: Added .github/workflows/docs-sync.yml workflow that automatically syncs README changes on push to master and commits the result, ensuring docs stay current without manual intervention
  • Improved script:
    • Refactored to extract readPackageJson() helper for reuse
    • Added readPackageName() to read package names from package.json
    • Made section entries async to support dynamic package discovery
    • Added warning output when packages are synced outside the curated list
  • Updated sidebar: Added legal-terms-privacy-policy and test-google-login to the docs navigation metadata
  • Minor updates: Updated existing package doc links and badges across several pages (git0, open-when-ready, about-system-info, manage-storage, etc.)

Implementation Details

The sync script now discovers packages in two ways:

  1. Curated list (PACKAGES): Manually configured packages with custom titles, icons, and categories
  2. Auto-discovery: Any packages/*/ directory with a README that isn't in the curated list gets a page under "Other" with the package name from package.json and a default icon

The CI workflow runs on changes to package READMEs, package.json files, or the sync script itself, ensuring documentation stays synchronized with source changes.

https://claude.ai/code/session_015dyCoRoTVAB3QpHcd93Uo8

- Auto-discover all packages/* READMEs; curated list keeps title/icon/category,
  unknown packages fall back to an "Other" category with the Package icon
- Add legal-terms and test-google-login pages
- Only delete previously generated pages, keeping hand-written ones
- New docs-sync workflow runs the sync on master and commits the result

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015dyCoRoTVAB3QpHcd93Uo8
@vercel

vercel Bot commented Sep 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
cccp-deployment Building Building Preview Sep 28, 2026 1:06am UTC
dev-tools-help-docs Building Building Preview Sep 28, 2026 1:06am UTC
test-google-login Building Building Preview Sep 28, 2026 1:06am UTC

@vtempest
vtempest merged commit fb457fa into master Sep 28, 2026
19 of 22 checks passed
@vtempest
vtempest deleted the claude/brave-hamilton-1xxe0l branch September 28, 2026 01:07
@codecov

codecov Bot commented Sep 28, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

This branch had an error being deployed

3 failed deployments
Preview – cccp-deployment — 0ff38e13 Deployed Sep 28, 2026 by vercel[bot]
Preview – dev-tools-help-docs — 0ff38e13 Deployed Sep 28, 2026 by vercel[bot]
Preview – test-google-login — 0ff38e13 Deployed Sep 28, 2026 by vercel[bot]
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.

2 participants