[Jmap] Éric Vyncke's No Objection on draft-ietf-jmap-contacts-09: (with COMMENT)

[Éric Vyncke via Datatracker <[e-mail]>]

Éric Vyncke has entered the following ballot position for
draft-ietf-jmap-contacts-09: 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-contacts/



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


# Éric Vyncke, INT AD, comments for draft-ietf-jmap-contacts-09

Thank you for the work put into this document.

Please find below some non-blocking COMMENT points (but replies would be
appreciated even if only for my own education).

Special thanks to Jim Fenton for the shepherd's detailed write-up including the
WG consensus and the justification of the intended status.

I hope that this review helps to improve the document,

Regards,

-éric

# COMMENTS (non-blocking)

## Section 1.4.1

In `This MUST be an integer >= 1, or null for no limit` does null represent the
integer 0 or NULL (lile in SQL) ? Suggest adding text to clarify, perhaps only
double quotes around null.

In `If true, the user may create an AddressBook in this account` suggest to use
'if and only if' construct.

## Section 2

Which type is 'id' ? Integer ? String ? Also applies to sections 3. If
well-known by the JMAP community, suggest a reminder in the terminology.

'isDefault' text could be clearer when no AddressBook has isdefault=true.

In the `mayRead`and others, should the following text be a normative MAY ?

## Section 3.3.1

Use of `UTCDate` seems to refer to UTC date and time. It is perhaps well-know
in the JMAP community but could benefit from some explanations.

Can all `String` be UTF-8 encoded ?