[OASIS Issue Tracker] (MQTT-351) "you" and your "loose" messages ...

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

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

Rahul Gupta commented on MQTT-351:
----------------------------------

Usage of you is not preferred in technical writing . Taking the same example :

1) you cannot use a string that would encode to more than 65535 bytes.

if we change this to

2) one cannot use a string that would encode to more than 65535 bytes.

We should choose to use 2) as it is not accusing or inspecting a reader directly that he will make this mistake rather telling in general that this mistake could be made.


> "you" and your "loose" messages ...
> -----------------------------------
>
>                 Key: MQTT-351
>                 URL: https://issues.oasis-open.org/browse/MQTT-351
>             Project: OASIS Message Queuing Telemetry Transport (MQTT) TC
>          Issue Type: Bug
>          Components: edits
>    Affects Versions: 5, wd10
>            Reporter: Brian Raymor
>            Assignee: Rahul Gupta
>            Priority: Trivial
>             Fix For: 5, wd10
>
>
> I'd recommend that we avoid the use of "you" ... there's also a spelling error below.
> This could be simplified. The maximum size of a string that can be passed in these UTF-8 encoded string components is ...
> 549 Consequently, there is a limit on the size of a string that can be passed in one of these UTF-8 encoded
> 550 string components; you cannot use a string that would encode to more than 65535 bytes.
> Actually this is redundant since there's text that follows which states:
> 552 Unless stated otherwise all UTF-8 encoded strings can have any length in the range 0 to 65535 bytes.
> !! This should be "lose" and not "loose":
> 1012 ...Hence, to ensure that
> 1013 you do not loose messages while disconnected, 
> 2875 A subscription’s Topic Filter can contain special wildcard characters, which allow you to subscribe to ...
> 2990 ... as in such cases you would want each message to be delivered to exactly one Client.



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