[quicwg/base-drafts] [Editorial] Lots of forward references (#3763)

Watson Ladd <notifications@github.com> Sun, 14 June 2020 22:54 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 EE5F63A07AC for <quic-issues@ietfa.amsl.com>; Sun, 14 Jun 2020 15:54:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.009
X-Spam-Level:
X-Spam-Status: No, score=-2.009 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_IMAGE_ONLY_16=1.092, 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 XUDqY9SFWCNP for <quic-issues@ietfa.amsl.com>; Sun, 14 Jun 2020 15:54:23 -0700 (PDT)
Received: from out-24.smtp.github.com (out-24.smtp.github.com [192.30.252.207]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C91613A079C for <quic-issues@ietf.org>; Sun, 14 Jun 2020 15:54:23 -0700 (PDT)
Received: from github-lowworker-943b171.ac4-iad.github.net (github-lowworker-943b171.ac4-iad.github.net [10.52.22.59]) by smtp.github.com (Postfix) with ESMTP id D67256A0DFA for <quic-issues@ietf.org>; Sun, 14 Jun 2020 15:54:22 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1592175262; bh=Bv5b3hmzHL3DtBbkpow6+g8q4c9ok7dWh+RIDA/YvJE=; h=Date:From:Reply-To:To:Cc:Subject:List-ID:List-Archive:List-Post: List-Unsubscribe:From; b=mm1SIcIMPdI3FAeTfOkF3hQlPTPbvaKVitLF4dr4zhJOPAZhUtRF6vLwXujomRroA p8UKnPmz0hJwWMhkbsfpb6+rJs2P5MjTLVfyb5vasI1m6B04S4MDliReywC2FZGBCD 1J6wtR2UoQMJ184IJnYmDBdXrIsrKsBXdKvHytek=
Date: Sun, 14 Jun 2020 15:54:22 -0700
From: Watson Ladd <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJK4KE3JTIP427RWLN2V46KFZ5EVBNHHCMDPNOE@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/issues/3763@github.com>
Subject: [quicwg/base-drafts] [Editorial] Lots of forward references (#3763)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5ee6aa9ec78a6_49e3fe9322cd96c3751b"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: wbl
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/NmdkxQ9xCdNSX64cRV0XA7QkLmI>
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: Sun, 14 Jun 2020 22:54:25 -0000

When I was reading quic-transport I found it very difficult to deal with the forward references. Streams are presented before connections, the overall state machine isn't introduced up front, packets come long after frames, and both are long before the wire formats are described. It might worth revisiting the section ordering.

-- 
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/issues/3763