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

From: Martin Thomson <[email-masked]>
Date: Sun, 19 Mar 2017 23:52:03 -0700

The current document structure has suffered a little from the large volume of changes that we've thrown at the spec.  Here's a structure that I think will survive a little better:

## Fluff

* Introduction (Why QUIC, really high level of what it does)
* Overview (see #410)

## High-Level Concepts

* Connections
   * lifecycle (include handshake overview here)
   * graceful shutdown
   * error handling
   * public reset (semantics, not bits)
   * source address validation and DoS
* Streams (lifecycle, purpose and function, priority, flow control)
* Packets and Frames
   * relationship between packets and frames
   * packetization
   * retransmission rules
   * pmtud
* Versions (version negotiation, version numbers)
* Connection IDs (why, migration, nat rebinding, changing ID, privacy)

## Mechanics

* Packet Format
   * long and short headers
   * what is constant between versions
   * definition of each of the packet types
* Packet Protection (key phases, AEAD)
* Frames (definition of each frame type; include current Sections 6+8)
* Handshake (crypto, transport parameters)
* Error Codes

## Boilerplate

* Security Considerations
* IANA
* etc...

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