[Gen-art] Genart last call review of draft-wilde-service-link-rel-06
Peter Yee <email@example.com> Tue, 20 November 2018 16:21 UTC
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 70D3912426A; Tue, 20 Nov 2018 08:21:54 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
From: Peter Yee <firstname.lastname@example.org>
Cc: email@example.com, firstname.lastname@example.org
Date: Tue, 20 Nov 2018 08:21:54 -0800
Subject: [Gen-art] Genart last call review of draft-wilde-service-link-rel-06
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:email@example.com?subject=unsubscribe>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:firstname.lastname@example.org?subject=subscribe>
X-List-Received-Date: Tue, 20 Nov 2018 16:21:54 -0000
Reviewer: Peter Yee Review result: Almost Ready I am the assigned Gen-ART reviewer for this draft. The General Area Review Team (Gen-ART) reviews all IETF documents being processed by the IESG for the IETF Chair. Please treat these comments just like any other last call comments. For more information, please see the FAQ at <https://trac.ietf.org/trac/gen/wiki/GenArtfaq>. Document: draft-wilde-service-link-rel-06 Reviewer: Peter Yee Review Date: 2018-11-20 IETF LC End Date: 2018-11-20 IESG Telechat date: Not scheduled for a telechat Summary: Almost ready. The document registers (under the RFC 8288 registry) link relation types for service document, service description, service metadata, and service status. It's missing a key section. Major issues: None. Minor issues: Page 8, Section 7: RFC 2223 requires you do more than provide an ellipsis here. You might want to consider what makes sense. Perhaps a discussion of what happens to a client that obtains a maliciously formatted service-desc or even an errant service-desc. While a human might be able to see through problems in a "service-doc", it's quite possible that a machine will want to take precautions about handling the received data and acting upon it. Nits/editorial comments: Page 1, Note to Readers: Presumably this section will be removed prior to publication. Page 3, 4th full paragraph, 1st sentence: Delete the comma after "consumption" and delete the "for" following that. Page 5, Section 3.3, 1st paragraph, 1st section: change "of" to "between". Put the section references in parentheses. Page 5, Section 3.3, 1st paragraph, 2nd sentence: insert "a" before "better".