Use annotations to add descriptions to types and links:
type Label {
annotation description :=
'Special label to stick on reviews';
required property comments -> str;
link review -> Review {
annotation description :=
'This review needs some attention';
};
}Retrieving the annotations can be done via an introspection query:
db> ... ... ... ... ... ...
with module schema
select ObjectType {
name,
annotations: {name, @value},
links: {name, annotations: {name, @value}}
}
filter .name = 'default::Label';{
Object {
name: 'default::Label',
annotations: {
Object {
name: 'std::description',
@value: 'Special label to stick on reviews'
}
},
links: {
Object {
name: 'review',
annotations: {
Object {
name: 'std::description',
@value: 'Special label to stick on reviews'
}
}
},
Object { name: '__type__', annotations: {} }
}
}
}Alternatively, the annotations can be viewed by the following REPL command:
db>
\d+ Labeltype default::Label {
annotation std::description := 'Special label to stick on reviews';
required single link __type__ -> schema::Type {
readonly := true;
};
single link review -> default::Review {
annotation std::description := 'Special label to stick on reviews';
};
required single property comments -> std::str;
required single property id -> std::uuid {
readonly := true;
constraint std::exclusive;
};
};