Gen-ART Last Call review of draft-ietf-httpbis-cache-groups-03

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/

Received on Monday, 24 February 2025 17:36:28 UTC