[quicwg/base-drafts] Short abstract (#92)

Martin Thomson <notifications@github.com> Mon, 19 December 2016 04:12 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 0121012950C for <quic-issues@ietfa.amsl.com>; Sun, 18 Dec 2016 20:12:33 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.419
X-Spam-Level:
X-Spam-Status: No, score=-7.419 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_IMAGE_ONLY_32=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-3.1, 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 ToqgilWqVPR1 for <quic-issues@ietfa.amsl.com>; Sun, 18 Dec 2016 20:12:31 -0800 (PST)
Received: from o5.sgmail.github.com (o5.sgmail.github.com [192.254.113.10]) (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 920CB129457 for <quic-issues@ietf.org>; Sun, 18 Dec 2016 20:12:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=github.com; h=from:reply-to:to:cc:subject:mime-version:content-type:content-transfer-encoding:list-id:list-archive:list-post:list-unsubscribe; s=s20150108; bh=ddSJQPOuLxPks1Agmo2VuuMqNtk=; b=cq4orYbDy+SSoIgs hoPw9kX+2puWh3fciobNTwUoNXOcILeEpQElwJ5/l13/8UtMtjcTDw6kakVDAUcs XhPh5LVRQCSyNM8jtQE5Oh7PRmfGEpHSH6h+UV8qiTa5ea+psIyxiFbFRk7DFcaR dnBuf92MZ75uQNTXqeVYbu7IrOo=
Received: by filter0624p1mdw1.sendgrid.net with SMTP id filter0624p1mdw1-7238-58575E2E-4 2016-12-19 04:12:30.130766449 +0000 UTC
Received: from github-smtp2b-ext-cp1-prd.iad.github.net (github-smtp2b-ext-cp1-prd.iad.github.net [192.30.253.17]) by ismtpd0004p1iad1.sendgrid.net (SG) with ESMTP id G9ifh5EqTuCDDC_KcpL3TQ for <quic-issues@ietf.org>; Mon, 19 Dec 2016 04:12:30.071 +0000 (UTC)
Date: Sun, 18 Dec 2016 20:12:29 -0800
From: Martin Thomson <notifications@github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/92@github.com>
Subject: [quicwg/base-drafts] Short abstract (#92)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_58575e2decbac_2b7b3fe704e5f134551239"; 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: l64QuQ2uJCcEyUykJbxN122A6QRmEpucztpreh3Pak3LaFI21u55O9EIOgYPszcyYJCk2Jt2LxXx1H mlpF3Agl0PXGLJjk974TZ96DlUPprUMNrrT6CxGuqc1wq/rTWycd+DJEKSz+Htr860C1gbdZE9Koio b7h5qskubIqmO2QO1BpkM0PRE4IS3aOzYU4j1qJPsZ3IeDt2PiJ/Gf+LueHljBvk+V1cTEZPFU3dDv s=
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/rHpc6I1YVZzaT1ZQMr2D0PrCtUA>
Cc: Subscribed <subscribed@noreply.github.com>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.17
Reply-To: Notification list for GitHub issues related to the QUIC WG <quic-issues@ietf.org>
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, 19 Dec 2016 04:12:33 -0000

The abstract was just a repetition of the introduction, which isn't really appropriate.  An abstract doesn't need rationale and all the padding, it should just explain the purpose of the document.  QUIC is conceptually very simple, let's capitalize on that.

I wanted to fix the first sentence of the intro to avoid duplication, but it really is a concise, well-constructed intro.  It could benefit from being split into smaller pieces though.
You can view, comment on, or merge this pull request online at:

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

-- Commit Summary --

  * Shorten the abstract
  * Small digestible chunks

-- File Changes --

    M draft-ietf-quic-transport.md (31)

-- Patch Links --

https://github.com/quicwg/base-drafts/pull/92.patch
https://github.com/quicwg/base-drafts/pull/92.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/92