RQML Reference
The current RQML schema is served at /schema/rqml-2.1.0.xsd. Use this page as an entry point to the element/attribute reference.
Common patterns
- IDs:
IdTypetokens, 2–80 chars, start with a letter; allow letters, digits,.,_,-. Keep stable across revisions. - References:
goalLink,edgelocators, andtestSuite/membersall point to existing IDs; the schema enforces this with keyrefs. - Trace endpoints:
edgeelements use structuredlocatorelements withlocal(same document, keyref-validated),doc(cross-document), orexternal(non-RQML URI) references. - Language: Use clear, testable prose; avoid ambiguity. Text blocks allow mixed content for formatting.
- Cardinality: Required elements are noted in each element page; optional sections may be omitted entirely.
Versioning
- Documents must set
rqml@versionto match the schema version, along with requireddocIdandstatus. - Validate with
xmllint --schema /path/to/rqml-x.y.z.xsd yourfile.rqml --noout.