Skip to content

DECLARATIVE-YAML-08: Optional, alias, oneOf and gap section nodes

The remaining body-node vocabulary — optional sections, heading aliases, a oneOf choice, and a gap allowance.

Builds on: DECLARATIVE-YAML-07: Declare required body sections

The declarative YAML artifact, verbatim — no code required.

body:
order: recognized-relative
sections:
- section: Summary
aliases: [Overview, TL;DR]
- oneOf: [Decision, Proposal]
- section: Out of scope
optional: true
- gap: { min: 0, max: 2 }
  • compileNode: section(names with aliases)
  • oneOf()
  • optional(spec)
  • gap({min,max})