[OASIS Issue Tracker] (MQTT-532) style: Section 5 heading differs from 3.1.1

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

    [ https://issues.oasis-open.org/browse/MQTT-532?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=69632#comment-69632 ] 

Ken Borgendale commented on MQTT-532:
-------------------------------------

We added the non-normative into the section title for chapter 5 as part of the TAB review.  This was part of the clarification that chapter 5 was fully non-normative (even if we think it should be followed).  We should not remove this.   

The spelling is non-normative if in lower case, and Non-normative if in upper case.  This can be restated in the first sentence.  I do not see the point of including the However.

> style: Section 5 heading differs from 3.1.1
> -------------------------------------------
>
>                 Key: MQTT-532
>                 URL: https://issues.oasis-open.org/browse/MQTT-532
>             Project: OASIS Message Queuing Telemetry Transport (MQTT) TC
>          Issue Type: Bug
>          Components: edits
>    Affects Versions: wd18
>            Reporter: Richard Coppen
>            Priority: Minor
>              Labels: editorial
>
> Section 5 heading reads:
> 5	Security (non-normative)
> 5.1 Introduction
> It is strongly recommended that Server implementations that offer TLS [RFC5246] should use TCP port 8883 (IANA service name: secure-mqtt).
> For 3.1.1 we say:
> 5      Security
> 5.1 Introduction
> This Chapter is provided for guidance only and is Non Normative. However, it is strongly recommended that Server implementations that offer TLS [RFC5246] SHOULD use TCP port 8883 (IANA service name: secure-mqtt).
> While it's true that the section is provided as implementer guidance only, the intent of the 3.1.1 wording to make a strong recommendation for using TLS on 8883. It's primarily a cosmetic change, but reverting to the 3.1.1 style makes it consistent 



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