Case Study
Historical document
This case study records early influences, design goals, and syntax proposals. It is not the normative specification and is not kept in lockstep with the language. For current rules, read the formal grammar, the extensions contract, and the conformance corpus.
The chapters cover the original design from background through implementation.
Chapters
- Background: formats considered and early readability assumptions.
- Design: design principles and reasons for a separate format.
- Syntax Walkthrough: early syntax proposals. The current rules are in the formal grammar.
- Parsing & AST: the proposed parsing strategy and AST shape.
- Compatibility, Comparison & Open Questions: migration and compatibility notes.
- Implementation & Reflection: implementation notes and original goals.
- Appendices: quick reference card, examples, and influences.
Related
- Examples: Carve source and HTML output.
- Formal grammar: EBNF specification.
- Reference implementation:
@markup-carve/carvein TypeScript.