W3C home > Mailing lists > Public > public-device-apis-log@w3.org > February 2019

[sensors] Non-normative Extensibility section uses normative language (#383)

From: Anssi Kostiainen via GitHub <sysbot+gh@w3.org>
Date: Fri, 08 Feb 2019 12:23:52 +0000
To: public-device-apis-log@w3.org
Message-ID: <issues.opened-408130326-1549628631-sysbot+gh@w3.org>
anssiko has just created a new issue for https://github.com/w3c/sensors:

== Non-normative Extensibility section uses normative language ==
There are multiple occurrences of normative terms ("must", "should" as defined in RFC2119) in the non-normative [Extensibility](https://w3c.github.io/sensors/#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.

Please view or discuss this issue at https://github.com/w3c/sensors/issues/383 using your GitHub account
Received on Friday, 8 February 2019 12:23:54 UTC

This archive was generated by hypermail 2.3.1 : Friday, 8 February 2019 12:23:54 UTC