Re: [Last-Call] Genart last call review of draft-ietf-jsonpath-iregexp-06

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Russ,

thank you for this review.

Two comments:

> Minor Concerns:
> 
> Section 3: A reference to ABNF is needed.  Since %s is being used,
> I believe that a reference to RFC 7405 is required.  Alternatively,
> the paragraph in Section 1.1 could be moved to Section 3.

We generally write IETF documents with the assumption that the terminology section has been read before reading other parts of the document.  Given that the reference to 5234/7405 is a third of a page away, it doesn’t seem additional text is needed.
There is also the issue that any additional text shortcutting to the references might preempt the important part of the text in Section 1.1, which specifies that the ABNF “characters” for this document are Unicode scalar values.

> Nits:
> 
> Section 3.1: s/_checking_/checking/

Well, this is the plaintext emulation of italic style, which seems quite appropriate for the occurrence of this term where it is being defined.

Grüße, Carsten

-- 
last-call mailing list
last-call@xxxxxxxx
https://www.ietf.org/mailman/listinfo/last-call




[Index of Archives]     [IETF Annoucements]     [IETF]     [IP Storage]     [Yosemite News]     [Linux SCTP]     [Linux Newbies]     [Mhonarc]     [Fedora Users]

  Powered by Linux