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