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

["Eric Vyncke (evyncke)" <[e-mail]>]

Thank you, Neil, for your reply.

About the plural form for urn:ietf:params:jmap:principals, may I suggest to update the text of section 1.5.1 because it is really implying that there is a single principal.

For your other points, my comments were non-blocking anyway ;-)

Best regards

-éric

From: Neil Jenkins <[e-mail]>
Date: Thursday, 18 April 2024 at 08:08
To: Eric Vyncke (evyncke) <[e-mail]>, iesg <[e-mail]>
Cc: [e-mail] <[e-mail]>, [e-mail] <[e-mail]>, IETF JMAP Mailing List <[e-mail]>, Bron Gondwana <[e-mail]>, [e-mail] <[e-mail]>
Subject: Re: Éric Vyncke's No Objection on draft-ietf-jmap-sharing-08: (with COMMENT)
Hi Éric,

Thank you for your comments.

- the abstract and contents present this I-D as a "data model" but, in my own
view, a data model does not include "methods" or actions. Suggest to augment
the abstract to also mention "methods"

I have left this as it was, as the introduction starts with a brief description of JMAP as a "generic protocol for synchronizing data", and the methods are just standard JMAP methods for doing this. I think it will be clear to anyone working in the ecosystem.

- even with a i18n section, section 2
allows for only one unknown-language version of "description" - section 1.5.1

This is true, and the same applies to name. Being able to provide multiple versions of the property with associated language tags adds a lot of complexity while being unlikely to be used widely in practice. It could of course be added by a future document.

I wonder why the plural form is used in urn:ietf:params:jmap:principals as there
can be only one principal

You can have more than one Principal, in fact a system with only one would not be very useful. Each Principal represents a user, group, or other entity with which you could share something.

Cheers,
Neil.