From 477954b4fd77d074fc46e67d5a664d227f9c6245 Mon Sep 17 00:00:00 2001 From: Martin Thomson Date: Thu, 24 Sep 2020 15:19:35 +1000 Subject: [PATCH] Reorder invariants Gorry thought that it might be worth saying what QUIC is first. I agree. Tiny tweaks to the intro to allow for the change. Including a new title. Closes #4118. --- draft-ietf-quic-invariants.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/draft-ietf-quic-invariants.md b/draft-ietf-quic-invariants.md index f98ef3f89e..f47d966f4f 100644 --- a/draft-ietf-quic-invariants.md +++ b/draft-ietf-quic-invariants.md @@ -75,12 +75,20 @@ code and issues list for this draft can be found at --- middle -# Introduction +# An Extremely Abstract Description of QUIC + +QUIC is a connection-oriented protocol between two endpoints. Those endpoints +exchange UDP datagrams. These UDP datagrams contain QUIC packets. QUIC +endpoints use QUIC packets to establish a QUIC connection, which is shared +protocol state between those endpoints. + + +# Fixed Properties of All QUIC Versions In addition to providing secure, multiplexed transport, QUIC {{QUIC-TRANSPORT}} -includes the ability to negotiate a version. This allows the protocol to change -over time in response to new requirements. Many characteristics of the protocol -will change between versions. +allows for the option to negotiate a version. This allows the protocol to +change over time in response to new requirements. Many characteristics of the +protocol could change between versions. This document describes the subset of QUIC that is intended to remain stable as new versions are developed and deployed. All of these invariants are @@ -106,14 +114,6 @@ version of QUIC. This document uses terms and notational conventions from {{QUIC-TRANSPORT}}. -# An Extremely Abstract Description of QUIC - -QUIC is a connection-oriented protocol between two endpoints. Those endpoints -exchange UDP datagrams. These UDP datagrams contain QUIC packets. QUIC -endpoints use QUIC packets to establish a QUIC connection, which is shared -protocol state between those endpoints. - - # Notational Conventions Packet diagrams in this document use a format defined in {{QUIC-TRANSPORT}} to