[Jmap] Paul Wouters' No Objection on draft-ietf-jmap-sharing-08: (with COMMENT)

[Paul Wouters via Datatracker <[e-mail]>]

Paul Wouters has entered the following ballot position for
draft-ietf-jmap-sharing-08: No Objection

When responding, please keep the subject line intact and reply to all
email addresses included in the To and CC lines. (Feel free to cut this
introductory paragraph, however.)


Please refer to https://www.ietf.org/about/groups/iesg/statements/handling-ballot-positions/ 
for more information about how to handle DISCUSS and COMMENT positions.


The document, along with other ballot positions, can be found here:
https://datatracker.ietf.org/doc/draft-ietf-jmap-sharing/



----------------------------------------------------------------------
COMMENT:
----------------------------------------------------------------------

Numerous sections use the bullet points and empty lines in way that 
"mis-group" the items for me, making it difficult to parse. I almost raised
this as a DISCUSS. An example:

*  accountIds: String[]

   A list of account ids. The Principal matches if any of the ids in this
   list are keys in the Principal's "accounts" property (i.e., if any of
   the account ids belong to the principal).
*  email: String

   The email property of the principal contains the given string.
*  name: String

To me this keeps reading as "A list of accounts..." belongs to "email: String".

IMHO, the proper way would be:

*  accountIds: String[]
   A list of account ids. The Principal matches if any of the ids in this
   list are keys in the Principal's "accounts" property (i.e., if any of
   the account ids belong to the principal).

*  email: String
   The email property of the principal contains the given string.

*  name: String
   stuff ...

Setion 3.6.1: What is the logic for "after" including the date and "before" not
including the date?