Hello Mario, Gavin,
Please find below the initial shepherd feedback for the latest
03<https://datatracker.ietf.org/doc/html/draft-ietf-regext-rdap-jscontact-03>
draft.
Thanks,
Jasdip
---
* Rationale
“provides a simpler and more efficient representation for contact information”
Is it possible someone could question the “efficient” part, given the RDAP
response with JSContact would likely be bigger in size than that with jCard?
E.g. the sample jscard member in Fig 1 is 2724 characters whereas the
equivalent vcardArray member in Fig 17 in RFC 9083 is 1842 chars, per this
word-count tool<https://wordcounter.net/character-count>. May help to elaborate
what we mean here with efficiency.
3. Using JSCard objects in RDAP Responses
“The JSCard "uid" property SHOULD contain the same value as the RDAP "handle"
property.”
Curious why it is not a MUST?
“To aid interoperability, RDAP providers are RECOMMENDED to use as map keys the
following string values and labels defined in [RFC5733]”
Should we elaborate upon the consequences if this recommendation is not
followed? Should this be a MUST?
“"org" in the "organizations" map for either the only or the internationalized
organization;”
Should we clarify further here? Are we trying to say: use it only when there is
a single org, whether internationalized or not?
“"addr" in the "addresses" map for either the only or the internationalized
postal address ;”
If we do end up clarifying for org, similar clarification would be needed here.
Nit: extra space before the semi-colon.
“"email" in the "emails" map for the email address;”
Should we address the EAI (email address internationalization) scenario here,
similar to org and addr i18n?
“If present, the localized versions of name, organization and postal address
MUST be inserted into the "localizations" map.”
For clarity, would it help to include an example for the localized versions?
“Implementers MAY use different mapping schemes to define keys for additional
entries of the aforementioned maps or others.”
Should we elaborate this further with an example? Do we need to discuss client
implications for this MAY?
4. Transition Considerations
4.2.1.6. Goals
Should we move this sub-section up to the top, so as to upfront give the reader
a sense of the “requirements” for the transition design?
“the response would always be compliant to [RFC9083];”
What does this mean when 9083 does not know about JSCard?
4.2.1.2. Stage 2: jCard sunset
“include a description reporting the jCard sunset end time”
Should we clarify that the notice’s description string would contain both the
time and date, as we do when defining eventDate in RFC
9083<https://datatracker.ietf.org/doc/html/rfc9083#section-4.5>?
“"rel": "deprecation"”
In various examples (Figures 2, 3, 4, and 5), we use this “deprecation” rel
type. Do we need to register it with the IANA Link Relations
registry<https://www.iana.org/assignments/link-relations/link-relations.xhtml>?
“plus the parameter "jscard" set to a true value”
Should we make it consistent with “1/true/yes” from section 4.2.1.3. Stage 3:
jCard deprecation?
6. IANA Considerations
“Extension identifier: jscard”
Should we version this extension as say, jscard_0, in case we need to evolve it
in the future? That said, we have not always versioned extensions in the IANA
RDAP
Extensions<https://www.iana.org/assignments/rdap-extensions/rdap-extensions.xhtml>
registry.
7. Security Considerations
“The only mandatory property, namely "uid", is usually an opaque string.”
Do we need to clarify further here, given “uid” would be a non-opaque handle in
jscard?
“redacted properties can be merely excluded without using placeholder values”
Now that we have the RDAP redaction
draft<https://datatracker.ietf.org/doc/draft-ietf-regext-rdap-redacted/>,
should we elaborate further vis-à-vis the Removal and/or Empty Value redaction
methods?
General comments:
1. Does the portion of the spec for jCard to JSContact transition signaling
add significant implementation overhead for RDAP servers and clients? Could an
out-of-band (OOB) method have been employed? (There is a similar transition
effort happening in the RPKI space, in moving from rsync to
RRDP<https://datatracker.ietf.org/doc/html/draft-ietf-sidrops-prefer-rrdp-01>,
but that seems more OOB.) Just wanted to ask in the spirit of “what not to do.”
:)
_______________________________________________
regext mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/regext
