docs(site): frame markdown-contract as a template-engine / CMS foundation#200
Merged
Merged
Conversation
sksizer
force-pushed
the
claude/docs-agent-markdown-generation-70tvgl
branch
from
July 3, 2026 21:33
297559d to
e0c78bc
Compare
Deploying markdown-contract-docs with
|
| Latest commit: |
7871eef
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://43868e2f.markdown-contract-docs.pages.dev |
| Branch Preview URL: | https://claude-docs-agent-markdown-g.markdown-contract-docs.pages.dev |
sksizer
changed the title
…gine / CMS Revise the "What it is not" section of the Why page so the CMS and template-engine disclaimers carry their nuance: markdown-contract is neither, but the same contract that validates and reads a document is the primitive both would build on. - CMS: a CMS needs create/validate/read over a document type; markdown-contract already gives validate+read from one contract, so a CMS could rest its "new document", save-time validation, and typed reads on it without those drifting apart. - Template engine: a contract declares a document's shape, which can be walked to emit an empty-but-valid skeleton — the exact dual of `init`, which infers a contract from documents. Emitting shape (never prose) is the core of a template engine.
sksizer
force-pushed
the
claude/docs-agent-markdown-generation-70tvgl
branch
from
July 3, 2026 21:36
e0c78bc to
7871eef
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sharpens the "What it is not" framing on the docs site —
sites/docs/src/content/docs/why.md. The two disclaimers now carry their nuance instead of a flat "no":init, which infers a contract from documents. Emitting shape (never prose) is the core of a template engine.The original "never generate content" boundary is preserved; the nuance is shape vs. prose.
Scope
This PR is docs-site copy only (one file). The architecture/product exploration this framing points at — a
markdown-contract newscaffolding verb — is drafted separately as planning docs in #201 (C-0011 capability + D-0017 decision), so it can land on its own timeline.