Skip to main content

Last Call Review of draft-ietf-httpbis-cache-groups-03
review-ietf-httpbis-cache-groups-03-genart-lc-kyzivat-2025-02-24-00

Request Review of draft-ietf-httpbis-cache-groups
Requested revision No specific revision (document currently at 07)
Type IETF Last Call Review
Team General Area Review Team (Gen-ART) (genart)
Deadline 2025-02-26
Requested 2025-02-12
Authors Mark Nottingham
I-D last updated 2025-10-30 (Latest revision 2025-05-16)
Completed reviews Artart IETF Last Call review of -03 by Marco Tiloca (diff)
Secdir IETF Last Call review of -03 by Barry Leiba (diff)
Genart IETF Last Call review of -03 by Paul Kyzivat (diff)
Assignment Reviewer Paul Kyzivat
State Completed
Request IETF Last Call review on draft-ietf-httpbis-cache-groups by General Area Review Team (Gen-ART) Assigned
Posted at https://mailarchive.ietf.org/arch/msg/gen-art/U0Hw-H_iwHG9N3gIs5dJHAMfpdM
Reviewed revision 03 (document currently at 07)
Result Ready w/nits
Completed 2025-02-24
review-ietf-httpbis-cache-groups-03-genart-lc-kyzivat-2025-02-24-00
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-ietf-httpbis-cache-groups-03
Reviewer: Paul Kyzivat
Review Date: 2025-02-24
IETF LC End Date: 2025-02-26
IESG Telechat date: ?

Summary:

This draft is basically ready for publication, but has nits that should 
be fixed before publication.

ISSUES: 0
NITS: 2

1) NIT: Lack of normative language for syntax

I gather this document intends to normatively specify some of the syntax 
of HTTP requests and responses. Yet the specification fails to use 
normative language. For instance, consider the following sentence from 
section 2:

"The Cache-Groups HTTP Response Header is a List of Strings 
[STRUCTURED-FIELDS]."

To clearly be normative, I would expect this to be stated as:

"The Cache-Groups HTTP Response Header MUST be a List of Strings 
[STRUCTURED-FIELDS]."

This problem is present in sections 2 and 3, and also in the reference 
[STRUCTURED-FIELDS].

2) NIT: Typo

In section 2.1:

s/The both/They both/