quicwg / base-drafts

Internet-Drafts that make up the base QUIC specification
https://quicwg.org
1.62k stars 204 forks source link

Auth48: Frequency of citations #4949

Closed MikeBishop closed 2 years ago

MikeBishop commented 2 years ago

The RFC Editor asks:

Throughout the text, we see repeated citations used each time a given term is mentioned.

For example:

Original:

Endpoints MUST treat a request or response that contains undefined or invalid pseudo-header fields as malformed (Section 4.1.3).

[Then, only one sentence later..]

Any request or response that contains a pseudo-header field that appears in a header section after a regular header field MUST be treated as malformed (Section 4.1.3).

Please consider whether each citation is necessary or if the repetition may begin to distract the reader.

In the HTML copy, this could be addressed by making the term itself a hyperlink, rather than spelling out the cross-reference in text each time. (See, for example, the hyperlinking of frame names in the HTTP/2 specification.)

MikeBishop commented 2 years ago

Fixed by #4963.