[quicwg/base-drafts] Confusing text around push streams (#2225)

ekr <notifications@github.com> Thu, 20 December 2018 23:05 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 4A79F131256 for <quic-issues@ietfa.amsl.com>; Thu, 20 Dec 2018 15:05:52 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.661
X-Spam-Level:
X-Spam-Status: No, score=-6.661 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.065, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_IMAGE_ONLY_28=1.404, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_HI=-5, 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 Ybiq0tc6C_tq for <quic-issues@ietfa.amsl.com>; Thu, 20 Dec 2018 15:05:50 -0800 (PST)
Received: from out-3.smtp.github.com (out-3.smtp.github.com [192.30.252.194]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8F9CD130F21 for <quic-issues@ietf.org>; Thu, 20 Dec 2018 15:05:49 -0800 (PST)
Date: Thu, 20 Dec 2018 15:05:47 -0800
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1545347147; bh=PNtBhfgFYLJyjXiJMD4VzNe6wcmMIwblrmYrY0w+g3E=; h=Date:From:Reply-To:To:Cc:Subject:List-ID:List-Archive:List-Post: List-Unsubscribe:From; b=pQLYypTDACYVsvhxU1BiBkRRriz0gOIAASqJViihgsXoFbzi4lOneXXN/XkdbIE4l q64sCWDEJfAJfY7tIqbUWd9Kyl5sRN4HRefEZcCfzqpe4E4YHOimxb4FOUFdXX8tLK kkK/RcRjYbUZUfApD9pjuw1o6KmZ5l39vR+CUxic=
From: ekr <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+0166e4abb1638fd0b3f242b7998beeeb0f9c37512283af4692cf000000011833e24b92a169ce17706f50@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/issues/2225@github.com>
Subject: [quicwg/base-drafts] Confusing text around push streams (#2225)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5c1c204b9f66a_4bb53f8eafed45b8102775"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: ekr
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/xxiApwRClyWNvC0d3kyanWAywWs>
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: Thu, 20 Dec 2018 23:05:52 -0000

S 3.2.2.

```
A push stream is indicated by a stream type of `0x50` (ASCII 'P'), followed by
the Push ID of the promise that it fulfills, encoded as a variable-length
integer. The remaining data on this stream consists of HTTP/3 frames, as defined
in {{frames}}, and fulfills a promised server push.  Server push and Push IDs
are described in {{server-push}}.
```

This isn't understandable without knowing what push is or what a PUSH
promise is. Am I supposed to get that from 7540? In either case, you
should clearly state that a push stream can only be used for a single
push promise (this is implied by the formatting). Happy to supply a PR if
we can agree on what's wanted?


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