Re: [quicwg/base-drafts] Fix spelling and style consistency nits (#3946)
Jana Iyengar <notifications@github.com> Thu, 23 July 2020 20:57 UTC
Return-Path: <noreply@github.com>
X-Original-To: quic-issues@ietfa.amsl.com
Delivered-To: quic-issues@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D986D3A0D99 for <quic-issues@ietfa.amsl.com>; Thu, 23 Jul 2020 13:57:20 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.101
X-Spam-Level:
X-Spam-Status: No, score=-3.101 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=github.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id MrJxOI38A_a3 for <quic-issues@ietfa.amsl.com>; Thu, 23 Jul 2020 13:57:19 -0700 (PDT)
Received: from out-26.smtp.github.com (out-26.smtp.github.com [192.30.252.209]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 521E73A0D90 for <quic-issues@ietf.org>; Thu, 23 Jul 2020 13:57:19 -0700 (PDT)
Received: from github-lowworker-a27607f.ash1-iad.github.net (github-lowworker-a27607f.ash1-iad.github.net [10.56.18.61]) by smtp.github.com (Postfix) with ESMTP id 759795E0EE9 for <quic-issues@ietf.org>; Thu, 23 Jul 2020 13:57:18 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1595537838; bh=Jib2iiJwFdcWSRFCXJrbS5af7cIv4KrH1g4fVeg/4o0=; h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:List-ID: List-Archive:List-Post:List-Unsubscribe:From; b=KoGNZ1shWhQa24OxzTMEZ5S1OI1AH+T7ql6hK1Z0ajofPpbWEPr/CFLQMqMkNKFcw /dDJPVP782uy21Mi8hBWM2StGE4Ot7Y1Co30Z7C+OCmjYi28D8Q1No/Mg60QyKeYVg qyaMGxU0Z6x6lcHeXGQNd85fKrvcm69U28InIJhU=
Date: Thu, 23 Jul 2020 13:57:18 -0700
From: Jana Iyengar <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJK4N34W4O3WQPJHR5755EXNK5EVBNHHCPGA5II@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/3946/review/454479546@github.com>
In-Reply-To: <quicwg/base-drafts/pull/3946@github.com>
References: <quicwg/base-drafts/pull/3946@github.com>
Subject: Re: [quicwg/base-drafts] Fix spelling and style consistency nits (#3946)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5f19f9ae6666b_7ab93fe158acd9643988a"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: janaiyengar
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
X-GitHub-Recipient-Address: quic-issues@ietf.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/dy32p1gfG40Hk4NMJwKkg_5im00>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
List-Id: Notification list for GitHub issues related to the QUIC WG <quic-issues.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic-issues/>
List-Post: <mailto:quic-issues@ietf.org>
List-Help: <mailto:quic-issues-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 23 Jul 2020 20:57:21 -0000
@janaiyengar commented on this pull request.
Thanks, Lars, a few suggestions.
> @@ -3667,12 +3667,12 @@ acknowledgements.
An endpoint measures the delays intentionally introduced between the time the
packet with the largest packet number is received and the time an acknowledgment
-is sent. The endpoint encodes this delay in the Ack Delay field of an ACK
+is sent. The endpoint encodes this delay in the ACK Delay field of an ACK
We shouldn't use "ACK delay" without defining it, and if we do, I would suggest using "acknowledgement delay" instead.
> @@ -3667,12 +3667,12 @@ acknowledgements.
An endpoint measures the delays intentionally introduced between the time the
packet with the largest packet number is received and the time an acknowledgment
-is sent. The endpoint encodes this delay in the Ack Delay field of an ACK
+is sent. The endpoint encodes this delay in the ACK Delay field of an ACK
frame; see {{frame-ack}}. This allows the receiver of the ACK to adjust for any
```suggestion
frame; see {{frame-ack}}. This allows the receiver of the ACK frame to adjust for any
```
> @@ -3720,7 +3720,7 @@ containing that information is acknowledged.
unless the endpoint has sent a RESET_STREAM for that stream. Once an endpoint
sends a RESET_STREAM frame, no further STREAM frames are needed.
-* ACK frames carry the most recent set of acknowledgements and the Ack Delay
+* ACK frames carry the most recent set of acknowledgements and the ACK delay
how about "and the acknowledgement delay from the largest acknowledged packet ({{host-delay}})" ?
> @@ -5284,8 +5284,9 @@ ACK Delay:
to the power of the value of the ack_delay_exponent transport parameter set by
the sender of the ACK frame; see {{transport-parameter-definitions}}. Scaling
in this fashion allows for a larger range of values with a shorter encoding at
- the cost of lower resolution. Because the receiver doesn't use the ACK Delay
- for Initial and Handshake packets, a sender SHOULD send a value of 0.
+ the cost of lower resolution. Because the receiver doesn't use the value in
+ the ACK Delay field for Initial and Handshake packets, a sender SHOULD send a
```suggestion
the ACK Delay field of Initial and Handshake packets, a sender SHOULD send a
```
--
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/quicwg/base-drafts/pull/3946#pullrequestreview-454479546
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- [quicwg/base-drafts] Fix spelling and style consi… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… ianswett
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… ianswett
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Lars Eggert
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson
- Re: [quicwg/base-drafts] Fix spelling and style c… Jana Iyengar
- Re: [quicwg/base-drafts] Fix spelling and style c… Martin Thomson