Subject: [quicwg/base-drafts] Auth48: Frequency of citations (Issue #4949)

From: Mike Bishop <[email-masked]>
Date: Mon, 14 Feb 2022 10:02:57 -0800

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.)

-- 
Reply to this email directly or view it on GitHub:
https://github.com/quicwg/base-drafts/issues/4949
You are receiving this because you are subscribed to this thread.

Message ID: <quicwg/base-drafts/issues/[email-masked]>