Skip to content
This repository was archived by the owner on May 9, 2026. It is now read-only.

docs(adr,protocol): v1 status sweep + block-library author guide (T-7.1)#145

Merged
slavasolutions merged 1 commit into
release/v1.0from
feat/v1-adr-sweep-docs-polish
May 7, 2026
Merged

docs(adr,protocol): v1 status sweep + block-library author guide (T-7.1)#145
slavasolutions merged 1 commit into
release/v1.0from
feat/v1-adr-sweep-docs-polish

Conversation

@slavasolutions

Copy link
Copy Markdown
Contributor

T-7.1 — ADR sweep + block-library author guide + CONTENT-PROTOCOL polish.

ADR sweep

  • 0007 (pages-as-folders) → Reframed by ADR-0021 (page block storage shifted to v1 dialect)
  • 0008 (saas-renderer-on-cloudflare-workers) → Superseded by ADR-0024 (Workers renderer dropped for self-hosted Astro)
  • 0021–0028 each gain an Implementation status (2026-05-07) section citing the PRs that landed each piece (or "scoped for v1.0 stamp" for items still in flight)

ADR README index

  • 0007 row updated to reframed
  • 0019 noted as skipped/reserved
  • 0021–0028 annotated with v1 impl status
  • New "v1 ADR set — one-line summaries" section

New file: docs/guides/block-library-authoring.md

~325 lines covering:

  • What a block library is (per ADR-0024 + 0028) — npm package exporting components + Zod schemas
  • Required exports (component + schema + name + version)
  • Widget vocabulary (ADR-0027): text, textarea, url, image, select, markdown
  • `optionsFromTokens` for binding to bucket tokens (ADR-0025)
  • Versioning + migrations (ADR-0022): when to bump block schemaVersion + how to ship a migration
  • Publishing cadence (ADR-0028): scaffolder lockstep, semver minor for new blocks, major for break
  • Worked Pricing block example (Zod → Astro component → register in package.json)
  • Reference: `@clearcms/blocks-marketing`

CONTENT-PROTOCOL polish (additive)

  • "What's new in v1" section near top (5 bullets: site-mode, theme tokens, block library, schemaVersion, markdown widget)
  • Cross-link to author guide
  • Renderer name fix: `clear-site` → `@clearcms/renderer` per ADR-0024

Changeset

Empty frontmatter — root docs, no package version bumps.

Independence

`git diff --stat origin/release/v1.0` shows only docs/* and .changeset/*. Zero S1-territory paths.

Closes T-7.1.

🤖 Generated with Claude Code

….1 draft)

DRAFT — speculative branch off release/v1.0. Do NOT merge until prereqs land
(T-5D.11 sections surface). Holding for Phase 7 sequencing.

ADR sweep:
- 0007 reframed by 0021 (page block storage shifted to v1 dialect)
- 0008 superseded by 0024 (Workers renderer dropped for self-hosted Astro)
- 0021–0028 carry "Implementation status (2026-05-07)" sections with PR
  references where shipped and "scoped for v1.0 stamp" where pending

ADR README index:
- 0007 row updated to reframed
- 0019 noted as skipped/reserved
- 0021–0028 annotated with v1 impl status
- New "v1 ADR set — one-line summaries" section

New file: docs/guides/block-library-authoring.md (~270 lines)
- What a block library is (per ADR-0024 + 0028)
- Required exports + widget vocabulary (ADR-0027)
- optionsFromTokens binding (ADR-0025)
- Versioning + migrations (ADR-0022)
- Publishing cadence (ADR-0028, scaffolder lockstep)
- Worked Pricing block example
- Reference: @clearcms/blocks-marketing

CONTENT-PROTOCOL polish (additive):
- "What's new in v1" section
- Cross-link to author guide
- Renderer name fixed (clear-site -> @clearcms/renderer)

Changeset has empty frontmatter — root docs, no package version bumps.

Closes T-7.1.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@slavasolutions slavasolutions merged commit f06c18c into release/v1.0 May 7, 2026
1 check passed
@slavasolutions slavasolutions deleted the feat/v1-adr-sweep-docs-polish branch May 7, 2026 10:42
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant