Skip to content

Commit 903de9f

Browse files
authored
Merge pull request #916 from wking/unknown-properties-one-must
config: Collapse extensibility to a single MUST
2 parents 68f17f5 + dba5778 commit 903de9f

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

config.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -452,7 +452,7 @@ Cleanup or debugging functions are examples of such a hook.
452452
Keys MUST NOT be an empty string.
453453
Keys SHOULD be named using a reverse domain notation - e.g. `com.example.myKey`.
454454
Keys using the `org.opencontainers` namespace are reserved and MUST NOT be used by subsequent specifications.
455-
Implementations that are reading/processing this configuration file MUST NOT generate an error if they encounter an unknown annotation key.
455+
Runtimes MUST handle unknown annotation keys like any other [unknown property](#extensibility).
456456

457457
Values MUST be strings.
458458
Values MAY be an empty string.
@@ -465,12 +465,12 @@ Cleanup or debugging functions are examples of such a hook.
465465

466466
## <a name="configExtensibility" />Extensibility
467467

468-
Runtimes that are reading or processing this configuration file MUST NOT generate an error if they encounter an unknown property.
469-
Instead they MUST ignore unknown properties.
468+
Runtimes MAY [log](runtime.md#warnings) unknown properties but MUST otherwise ignore them.
469+
That includes not [generating errors](runtime.md#errors) if they encounter an unknown property.
470470

471471
## Valid values
472472

473-
Runtimes that are reading or processing this configuration file MUST generate an error when invalid or unsupported values are encountered.
473+
Runtimes MUST generate an error when invalid or unsupported values are encountered.
474474
Unless support for a valid value is explicitly required, runtimes MAY choose which subset of the valid values it will support.
475475

476476
## Configuration Schema Example

0 commit comments

Comments
 (0)