Section 27 of 102
26. Annotations and Metadata
Stable section ID: S05-CON-007-SECTION-27 · 39 content blocks
Annotations provide supplemental information that does not alter core BDL engineering semantics unless a Profile explicitly assigns meaning to it.
Annotations may include:
human-readable descriptions;
labels;
translations;
drawing references;
authoring notes;
review comments;
visualization preferences;
manufacturer information;
user-interface hints;
research tags.
Example:
- @label("Kitchen Service Cartridge")
- @drawing_reference("A-501", detail: "3")
- @review_status("pending structural review")
- cartridge Kitchen_01 : KitchenServiceCartridge {
- // Definition
}
Core metadata shall include:
author;
organization;
creation date;
modification date;
document status;
source;
approval;
confidentiality;
applicable configuration.
Metadata that affects engineering interpretation shall be promoted to a typed core Property rather than left as an informal annotation.
Tools may ignore unknown noncritical annotations but shall preserve them during round-trip editing where possible.
Annotations shall not override:
identity;
Type;
units;
constraints;
Profiles;
certification;
configuration state.