Skip to content

docs: consolidate root docs (fold BOUNDARIES, fix doc maps) - #177

Merged
arzafran merged 1 commit into
mainfrom
docs/consolidate-root
Jun 3, 2026
Merged

docs: consolidate root docs (fold BOUNDARIES, fix doc maps)#177
arzafran merged 1 commit into
mainfrom
docs/consolidate-root

Conversation

@arzafran

@arzafran arzafran commented Jun 3, 2026

Copy link
Copy Markdown
Member

Phase 4 of the docs consolidation.

  • Fold BOUNDARIES.md into ARCHITECTURE.md as a new "Customization Boundaries" section, and delete the standalone file (it was 64 lines of build-vs-extend philosophy that belongs with architecture).
  • Fill the AGENTS.md Versioning section (was a TODO placeholder from docs: consolidate engineering standards into AGENTS.md #175) with the semver-for-a-template policy summary, linking CHANGELOG.md.
  • Fix the doc maps in both AGENTS.md and README.md: drop the now-gone BOUNDARIES.md row, add COMPONENTS.md / CHANGELOG.md / SECURITY.md, and dedupe the README "Components" label (inventory vs UI reference).
  • Replace stray em dashes with hyphens/colons in the touched docs (per the no-em-dash convention).

Test plan

  • bun run check green
  • No dangling BOUNDARIES.md references anywhere
  • No em dashes left in README.md / ARCHITECTURE.md / AGENTS.md

Fold BOUNDARIES.md into ARCHITECTURE.md (new Customization Boundaries section)
and delete it. Fill the AGENTS.md Versioning section (links CHANGELOG.md). Fix
the AGENTS.md and README.md doc maps: drop the BOUNDARIES row, add COMPONENTS /
CHANGELOG / SECURITY, dedupe the README Components label. Replace stray em
dashes with hyphens/colons in the touched docs.
@vercel

vercel Bot commented Jun 3, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
satus Ready Ready Preview, Comment Jun 3, 2026 12:58pm

@arzafran
arzafran merged commit 8f3a1d0 into main Jun 3, 2026
8 checks passed
@arzafran arzafran mentioned this pull request Jun 3, 2026
2 tasks
arzafran added a commit that referenced this pull request Jun 3, 2026
COMPONENTS.md was stale (missing the new stripHtmlTags util) -- regenerate via
generate:manifest. Add the post-2.0.1 work to the CHANGELOG [Unreleased]: the
COMPONENTS.md generator (#178), root-docs consolidation (#177), and the HubSpot
HTML-sanitizer hardening (#179, #180).
@arzafran
arzafran deleted the docs/consolidate-root branch June 4, 2026 20:09
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.

1 participant