IETF Logo Mail Archive

Re: [quicwg/base-drafts] Restructure document (#411)

Martin Thomson <notifications@github.com> Mon, 24 September 2018 21:40 UTC

Return-Path: <bounces+848413-a050-quic-issues=ietf.org@sgmail.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 B8E00131102 for <quic-issues@ietfa.amsl.com>; Mon, 24 Sep 2018 14:40:16 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.01
X-Spam-Level:
X-Spam-Status: No, score=-3.01 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_NONE=-0.0001, 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 HvnYn5WhoFdF for <quic-issues@ietfa.amsl.com>; Mon, 24 Sep 2018 14:40:14 -0700 (PDT)
Received: from o9.sgmail.github.com (o9.sgmail.github.com [167.89.101.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 4FD721310AC for <quic-issues@ietf.org>; Mon, 24 Sep 2018 14:40:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=github.com; h=from:reply-to:to:cc:in-reply-to:references:subject:mime-version:content-type:content-transfer-encoding:list-id:list-archive:list-post:list-unsubscribe; s=s20150108; bh=k3ycVEZao4G87iIu2FVz61W2fZQ=; b=D7GCoKe9wwi/6qMQ MlYraUrBsOZizgiptx5VtYPzXYCnYgH9likJHqaxG9i0EOGl6gCet44IfO9h99y3 YElGn34t/MrgrgAoa1mVzHaj0RPiAJuZIiGyRtCsS5NJmsRfHhz/RBT0P0clYjkJ XF1RdWw5GLqHL3pSNalaMqtP9B0=
Received: by filter0786p1las1.sendgrid.net with SMTP id filter0786p1las1-29663-5BA959BC-1A 2018-09-24 21:40:12.28798174 +0000 UTC m=+1555813.901041255
Received: from github-lowworker-39ccb07.cp1-iad.github.net (unknown [192.30.252.40]) by ismtpd0017p1iad2.sendgrid.net (SG) with ESMTP id PR0kajT4ThWSQDpnnTf3ZA for <quic-issues@ietf.org>; Mon, 24 Sep 2018 21:40:12.059 +0000 (UTC)
Received: from github.com (localhost [127.0.0.1]) by github-lowworker-39ccb07.cp1-iad.github.net (Postfix) with ESMTP id 1CE6D400D0D for <quic-issues@ietf.org>; Mon, 24 Sep 2018 14:40:12 -0700 (PDT)
Date: Mon, 24 Sep 2018 21:40:12 +0000
From: Martin Thomson <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+0166e4ab8bca5f9ae3a57762bf56ae72c754f616424c257a92cf0000000117c11bbc92a169ce0cd5d91f@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/issues/411/424135023@github.com>
In-Reply-To: <quicwg/base-drafts/issues/411@github.com>
References: <quicwg/base-drafts/issues/411@github.com>
Subject: Re: [quicwg/base-drafts] Restructure document (#411)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5ba959bc126d5_4bf23f92078d45b893102f"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: martinthomson
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
X-GitHub-Recipient-Address: quic-issues@ietf.org
X-SG-EID: l64QuQ2uJCcEyUykJbxN122A6QRmEpucztpreh3Pak0/Nvhjkga7TTRqY63rf1kNCnJTSL0N/J92lk xTnA7NEeOiEO9x/RqAXWiziuTBLcX64Dla8HOT5lbCSf5mWiKzWfuhcL3C+DwRvMsTkq4XMlC0dtpo 3CTEjkj6jDVMf+3zLbHLE4GY/4ZeLWuXCloOIM5jzZyS+RUMMLUY3jqA4OfiF1pDDr9TTizl+5Pt8+ Y=
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/d7TKsh872lXktOsjjXTbmXEZAHE>
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: Mon, 24 Sep 2018 21:40:17 -0000

Discussed on 2018-09-24:

Proposed structure w/ notes:

1. Introduction
2. Overview
3. Streams (might be multiple top-level sections)
   a. concepts
   b. lifecycle
   c. flow control
4. Connection Handshake
   a. Example Handshake (high level)
   b. Packet Handling
   c. Version Negotiation
   d. Retry (tokens, etc....)
   e. Handshake Packets (cite TLS drafts)
   f. Transport parameters (what they are for, not the format)
5. Connection Migration
6. Connection Shutdown
7. Packets and Frames (format, layout, coalescing)
8. Sending and Resending Packets
9. Acknowledging Packets
10. Packet Size (Initial size, PMTUD etc...)
11. Version Numbers
12. Long and Short Headers
13. Packet Formats
14. Transport Parmeters
15. Frame Formats
16. Error Codes
17. Security Considerations
18. IANA
19. Other stuff...

>From Section 11 onwards, try to keep to pure format and only have minimal description of semantics.  Most of the semantic stuff should already be covered.

-- 
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/411#issuecomment-424135023

v2.23.0 | Report a Bug | By Email