Headings that repeat: changelogs

author-04 · YAML

A counted slot lets one heading legitimately recur as peers — with minContains / maxContains occurrence bounds — instead of tripping the duplicate-section rule.

Builds on: Frontmatter and required sections

The artifact

The declarative YAML artifact, verbatim — no code required.

changelog.contract.yaml

mcVersion: 2
kind: contract
body:
  sections:
    - section: Release
      minContains: 1  # at least one release entry, repeatable
      sections:
        - section: Added
          minContains: 0
          maxContains: 1
        - section: Fixed
          minContains: 0
          maxContains: 1

What it exercises

• repeatable sections
• occurrence bounds (minContains / maxContains)
• nested section grammars (hoisted onto the node)

Continue

• Previous: House rules as text constraints
• Next: Route a whole tree with one config
• Group: Author contracts in YAML · All examples
• Reference: Declarative YAML reference