Skip to content

Reference

Reference — precise, look-it-up facts. Not a tutorial; no narrative.

Page What it gives you
Commands Every make target and CLI command, with exit-code meaning
Schema reference Generated HTML reference (entities, types, facets, xs:documentation), produced from the XSD by xs3p

Authoritative specifications

The deeper, authoritative reference for this feature lives in the planning artifacts (outside the docs site, under version control):

  • specs/001-codespace-xml-scaffold/spec.md — the feature specification (WHAT/WHY).
  • specs/001-codespace-xml-scaffold/plan.md — the implementation plan.
  • specs/001-codespace-xml-scaffold/data-model.md — entities and field rules.
  • specs/001-codespace-xml-scaffold/contracts/ — the CLI and pipeline contracts.

Generated reference

make gen-schema-docs (re)generates the schema reference from the XSD via the vendored xs3p stylesheet — every element, type, facet and xs:documentation note — produced from the schema so it cannot drift (ADR 0011). The committed page is regenerated by CI; a stale copy fails the drift gate.