2.3 Variable Header

XMLWordPrintable

    • Type: Bug
    • Resolution: Fixed
    • Priority: Major
    • None
    • Affects Version/s: 3.1.1
    • Component/s: edits
    • None
    • Environment:

      Grammar

    • Hide

      Make some and several explicit lists, if the items are important enough to reference. Check draft for other uses of some (this is the only case of several)

      Show
      Make some and several explicit lists, if the items are important enough to reference. Check draft for other uses of some (this is the only case of several)

      2.3 Variable Header reads:

      *****
      Some types of MQTT Control Packets contain a variable header component. It resides between the fixed header and the payload. The content of the variable header varies depending on the Packet type, however one field - the Packet Identifier - is common to several packet types.
      *****

      The better practice is to not say Some types or *several packet types."

      If it is important information, spell out which MQTT Control Packets have a variable header component. and list the packet types with a Packet Identifier.

      Otherwise the text is vague and every users must puzzle that out for themselves. You use some/Some a total of ten times in the draft.

            Assignee:
            Rahul Gupta (Inactive)
            Reporter:
            Patrick Durusau
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: