search

w3c / sensors

Generic Sensor API
https://www.w3.org/TR/generic-sensor/
Other
127 stars 59 forks source link

Non-normative Extensibility section uses normative language #383

Closed anssiko closed 5 years ago

anssiko commented 5 years ago

There are multiple occurrences of normative terms ("must", "should" as defined in RFC2119) in the non-normative Extensibility section and its subsections that inherit the non-normative status of its parent. By convention, for consistency and clarity, non-normative sections typically do not use any normative terms.

Maybe this issue could be addressed by adding a note below the "This section is non-normative." statement to clear any confusion. For example:

Note: This section and its subsections are marked as non-normative but provide guidance to extension specification authors using normative language. From implementers' point of view, this section and its subsections are considered informative.

anssiko commented 5 years ago

Slightly reworded PR https://github.com/w3c/sensors/pull/384.