[OASIS Issue Tracker] (MQTT-520) Yellow highlighting?

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

Ken Borgendale created MQTT-520:
-----------------------------------

             Summary: Yellow highlighting?
                 Key: MQTT-520
                 URL: https://issues.oasis-open.org/browse/MQTT-520
             Project: OASIS Message Queuing Telemetry Transport (MQTT) TC
          Issue Type: Bug
          Components: edits
    Affects Versions: 5, CSD01
            Reporter: Ken Borgendale
            Priority: Minor


TAB-1570 - Patrick Durusau

This is a follow-on from my comment about conformance clauses needing to invoke more that the MUST statements in the specification. 

If you agree that the non-highlighted but normative text is also important for conformance, then the yellow-highlighting of MUST statements is distracting at best and mis-leading at worse. 

No conforming use of MQTT can be constructed reading only the highlighted text so why bother? Non-normative text should be marked (as you have) or put in comments or examples. 

You wrote normative prose to define MQTT so why not require people to read all of it?



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)