diff --git a/index.html b/index.html index 13fced8..06ba4ca 100644 --- a/index.html +++ b/index.html @@ -693,17 +693,17 @@

Options

Options Extensibility

-Implementations may extend an `options` object with additional properties. -Property keys may be any string but they should be appropriately namespaced (for example by using URIs) +Implementations MAY extend an `options` object with additional properties. +Property keys can be any string but they should be appropriately namespaced (for example by using URIs) in order to avoid collisions with extensions in other implementations.

-As extension properties are implementation specific, they should not be mandatory. +As extension properties are implementation specific, they ought not be mandatory. This is to maintain interoperability by avoiding clients needing to be modified to use a specific implementation.

-When adding an extension `options` property, consider if providing optionality to clients is necessary. -If not, using instance configuration to vary API functionality may be a preferable approach. +When adding an extension `options` property, consider whether providing optionality to clients is necessary. +If not, using instance configuration to vary API functionality might be a preferable approach.