quicwg / base-drafts

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

Auth48: Difficult to parse sentence / duplicated words #4970

Closed LPardue closed 2 years ago

LPardue commented 2 years ago

The repeated "when" clauses in this sentence make it difficult to parse. If our suggestion does not correctly capture your intent, could you please rephrase?

Original: A stream becomes unblocked when the Insert Count becomes unblocked when the Insert Count becomes greater than or equal to the Required Insert Count for all encoded field sections the decoder has started reading from the stream.

Perhaps: A stream becomes unblocked when the Insert Count becomes unblocked. When the Insert Count becomes greater than or equal to the Required Insert Count for all encoded field sections, the decoder has started reading from the stream.

MikeBishop commented 2 years ago

It actually looks as though the words "becomes unblocked when the Insert Count" are duplicated, which would make the corrected text:

A stream becomes unblocked when the Insert Count becomes greater than or equal to the Required Insert Count for all encoded field sections the decoder has started reading from the stream.

That might still be confusing, but the proposed text certainly isn't the right change.

The key point to capture is:

MikeBishop commented 2 years ago

Fixed in #4926.