Skip to content

Commit 6dc9b50

Browse files
authored
docs(schema): clarify extension key omission guidance (#493)
1 parent 197315f commit 6dc9b50

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

schema/knowledge_unit.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@
4747
"$defs": {
4848
"Extensions": {
4949
"type": "object",
50-
"description": "Implementation-specific fields. Not portable across implementations; consumers MUST ignore unknown keys and MUST NOT rely on their presence. Keys MUST use namespace:key format with a lowercase implementation slug.",
50+
"description": "Implementation-specific fields. Not portable across implementations; consumers MUST ignore unknown keys and MUST NOT rely on their presence. Keys MUST use namespace:key format with a lowercase implementation slug. Producers SHOULD only include keys they have actually set, and SHOULD NOT emit a key with a null or empty placeholder to represent an absent value, so that key-presence within a namespace is meaningful. This recommendation applies to producers and does not weaken the consumer-side rule above.",
5151
"patternProperties": {
5252
"^[a-z0-9][a-z0-9_-]*:\\S+$": true
5353
},

0 commit comments

Comments
 (0)