Skip to content

Consolidate community pages into root markdown#211

Merged
em3s merged 3 commits intomainfrom
docs/community-ssot-consolidation
Mar 3, 2026
Merged

Consolidate community pages into root markdown#211
em3s merged 3 commits intomainfrom
docs/community-ssot-consolidation

Conversation

@em3s
Copy link
Copy Markdown
Contributor

@em3s em3s commented Mar 3, 2026

Summary

Convert the website's community section to reference root markdown files as the single source of truth.

The website/src/content/docs/community/ directory had 5 pages duplicating or diverging from root files (CONTRIBUTING.md, ROADMAP.md), or existing only on the website without a root SSOT. This consolidates them: root files become the canonical source, and the website gets a single hub page linking to GitHub.

Changes

  • Create GOVERNANCE.md and RELEASES.md (converted from community pages)
  • Integrate development.mdx content into CONTRIBUTING.md as "Development setup" and "PR workflow" sections
  • Add community.mdx hub pages (en/ko) with CardGrid + 6 LinkCards pointing to GitHub
  • Update astro.config.mjs: single slug sidebar entry
  • Update ~25 internal links across docs, stories, blog posts, and TM files to GitHub URLs
  • Delete 10 community pages (en 5 + ko 5)

Reviewer notes

  • starlight-links-validator passes: All internal links are valid.
  • TM source/target pairs updated to prevent translation build breakage

Checklist

  • Context added in description
  • Self-reviewed the diff
  • Build and lint check run (npm run build — link validation passed)
  • Tests added/modified — N/A (docs-only change)
  • Breaking changes noted — N/A
  • Performance impact reviewed — N/A

Replace 10 individual community pages (en+ko) with a single hub page
per locale that links to root markdown files as the source of truth.

- Create GOVERNANCE.md and RELEASES.md from website community pages
- Integrate development.mdx content into CONTRIBUTING.md
- Add CardGrid hub pages (community.mdx) for en and ko
- Add redirects for all old community URLs
- Update ~25 internal links across docs, stories, TM files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dosubot dosubot bot added size:XL This PR changes 500-999 lines, ignoring generated files. documentation Improvements or additions to documentation labels Mar 3, 2026
em3s and others added 2 commits March 3, 2026 10:36
The old community pages are deleted, so Astro won't generate those
routes — redirects are not needed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@em3s em3s changed the title Consolidate community pages into root markdown SSOT with hub page Consolidate community pages into root markdown Mar 3, 2026
@em3s em3s merged commit e7e4eeb into main Mar 3, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant