States

Documentation status: reference — see Maturity and evidence.

States make the meaningful phases of a concept lifecycle explicit. They should represent observable business situations rather than temporary implementation details.

states:
  - Draft:
      caption: "#Draft"
  - Approved:
      caption: "#Approved"

The exact state shape depends on the grammar of the targeted Runtime version. When a structure is named through its display-name rule, carry the name in the YAML key instead of duplicating it in an artificial name attribute.

See Transitions for controlled moves between states.