3 definitions in this file:

Accepts one of:

  • docOriginValue
  • object — Full docOrigin form: the overall origin, the authorship, an optional explanatory note, and per-block overrides. A document MAY be 'authored' overall while individual blocks were 'extracted' or 'generated'.
  • The dominant origin of the document as a whole. When blocks differ, choose the origin of the document's substantive prose; record exceptions in blocks. Who or what wrote the document's words, as a single value for the document as a whole. When production was mixed, record the least-supervised method that contributed substantively (a mostly human doc with AI-drafted sections is 'ai-assisted'). Note the interaction with origin: an origin of 'generated' implies 'machine-generated' or 'ai-generated' authorship — the schema rejects other pairings when both fields are set. Plain-text note explaining the origin (e.g., 'Authored as the spec for the v3 rebuild; prop table regenerated from source on each release'). MUST NOT contain markup. Per-block overrides for blocks whose origin or authorship differs from the document-level values. Keys are document block kinds (e.g., 'api', 'guidelines', 'accessibility') matching the kind of a block in this entity's documentBlocks or agentDocumentBlocks. A value is either a bare origin string (the common case) or an object carrying origin and/or authorship when the block's production method also differs — an authored, human-written doc whose prop table is AI-generated records that here. List only the exceptions. A key that matches no block in the entity is a defect in the document (validators resolve keys against the entity's blocks).
References: docOriginValue, authorshipValue, plainNote [ "extracted", { "overall": "authored", "authorship": "ai-assisted", "note": "Written as the spec for the v3 rebuild; the prop table is regenerated from source on each release.", "blocks": { "api": "generated" } }, { "overall": "reconstructed", "authorship": "ai-generated", "note": "Drafted by an agent from team knowledge; not yet verified against the implementation." }, { "overall": "authored", "authorship": "human", "note": "Human-written spec; the prop table alone is regenerated from type definitions on each release.", "blocks": { "api": { "origin": "generated", "authorship": "machine-generated" } } } ]

Allowed values:

  • human
  • ai-assisted
  • ai-generated
  • machine-assisted
  • machine-generated

Allowed values:

  • authored
  • generated
  • extracted
  • reconstructed

Design System Documentation Spec (DSDS) 0.13.0 — Draft Specification

GitHub