[quicwg/base-drafts] QPACK editorial revision (#2759)

afrind <notifications@github.com> Wed, 29 May 2019 16:26 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 3D07F1201CB for <quic-issues@ietfa.amsl.com>; Wed, 29 May 2019 09:26:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -8.009
X-Spam-Level:
X-Spam-Status: No, score=-8.009 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_HI=-5, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_DKIMWL_WL_HIGH=-0.01] 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 XbdGgLIk4Xdd for <quic-issues@ietfa.amsl.com>; Wed, 29 May 2019 09:26:06 -0700 (PDT)
Received: from out-6.smtp.github.com (out-6.smtp.github.com [192.30.252.197]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CF34212002F for <quic-issues@ietf.org>; Wed, 29 May 2019 09:25:54 -0700 (PDT)
Date: Wed, 29 May 2019 09:25:53 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1559147153; bh=JH0sXlZe2naDriarKdaG/j3Ua/676FVRBM9TzipJLDY=; h=Date:From:Reply-To:To:Cc:Subject:List-ID:List-Archive:List-Post: List-Unsubscribe:From; b=vnPiEhOGVkRBazGAu+qcjrMcTsqj1JhGXP5e5VqLPXBKHDI6EI3q3bKG5k2cbJr5F J3AMbm3k1shQxNhjmlQfVC9lFM/uXgHmA1sWsQVURRJ3pRFB9wIb9R3gGyHALPZ+p9 bpSZJ9OMyA2+Yy0UFZyN94hTkyYAfQPv9elN3Q7k=
From: afrind <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJK5KIIIJWWOCWSWA6UN27PSRDEVBNHHBVUIAB4@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/2759@github.com>
Subject: [quicwg/base-drafts] QPACK editorial revision (#2759)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5ceeb2918db83_11863faa366cd96c2409f1"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: afrind
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/s4XSMENMegpWpa-M6-7hbJBMiRs>
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: Wed, 29 May 2019 16:26:09 -0000

I made a major editorial pass on the QPACK spec, hoping to address some of the issues mentioned in #2339, and others.

I separated logical changes into individual commits in this PR, which should (hopefully) make it a bit easier to review the changes.  For example, some sections were reordered and updated, so there's a commit that just moves the text without changes.  

The "Editorial Clarifications" commit should not impact design at all, but does add new text explaining the handling of certain cases.

In addition to looking at the individual changes, giving the final product a read from start to finish would also be appreciated.
You can view, comment on, or merge this pull request online at:

  https://github.com/quicwg/base-drafts/pull/2759

-- Commit Summary --

  * [qpack] rewrite abstract
  * [qpack] Minor editorial pass
  * [qpack] Prefer header blocks to H3 frame types
  * [qpack] Reorder sections
  * [qpack] Editorial Clarifications
  * [qpack] Move some decoder text to the decoder section
  * [qpack] Move some explanatory text from Wire Format to Decoder section
  * [qpack] Make the instruction text more consistent
  * [qpack] Remove redundant stream text, update TOC

-- File Changes --

    M draft-ietf-quic-qpack.md (516)

-- Patch Links --

https://github.com/quicwg/base-drafts/pull/2759.patch
https://github.com/quicwg/base-drafts/pull/2759.diff

-- 
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/2759