Re: p2: Purely editorial feedback

Amos Jeffries <squid3@treenet.co.nz> Sun, 21 April 2013 02:40 UTC

Return-Path: <ietf-http-wg-request@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 692A521F8B07 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Sat, 20 Apr 2013 19:40:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -10.537
X-Spam-Level:
X-Spam-Status: No, score=-10.537 tagged_above=-999 required=5 tests=[AWL=0.062, BAYES_00=-2.599, RCVD_IN_DNSWL_HI=-8]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id d4iq3FRbHXXv for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Sat, 20 Apr 2013 19:40:39 -0700 (PDT)
Received: from frink.w3.org (frink.w3.org [128.30.52.56]) by ietfa.amsl.com (Postfix) with ESMTP id 251A821F8AE8 for <httpbisa-archive-bis2Juki@lists.ietf.org>; Sat, 20 Apr 2013 19:40:39 -0700 (PDT)
Received: from lists by frink.w3.org with local (Exim 4.72) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1UTkCD-0001q5-HF for ietf-http-wg-dist@listhub.w3.org; Sun, 21 Apr 2013 02:40:05 +0000
Resent-Date: Sun, 21 Apr 2013 02:40:05 +0000
Resent-Message-Id: <E1UTkCD-0001q5-HF@frink.w3.org>
Received: from maggie.w3.org ([128.30.52.39]) by frink.w3.org with esmtp (Exim 4.72) (envelope-from <squid3@treenet.co.nz>) id 1UTkCA-0000kh-1C for ietf-http-wg@listhub.w3.org; Sun, 21 Apr 2013 02:40:02 +0000
Received: from ip-58-28-153-233.static-xdsl.xnet.co.nz ([58.28.153.233] helo=treenet.co.nz) by maggie.w3.org with esmtp (Exim 4.72) (envelope-from <squid3@treenet.co.nz>) id 1UTkC9-00050z-Aw for ietf-http-wg@w3.org; Sun, 21 Apr 2013 02:40:01 +0000
Received: from [192.168.2.7] (103-9-43-128.flip.co.nz [103.9.43.128]) by treenet.co.nz (Postfix) with ESMTP id D5A39E6EC1 for <ietf-http-wg@w3.org>; Sun, 21 Apr 2013 14:39:38 +1200 (NZST)
Message-ID: <5173516A.8000807@treenet.co.nz>
Date: Sun, 21 Apr 2013 14:39:38 +1200
From: Amos Jeffries <squid3@treenet.co.nz>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130328 Thunderbird/17.0.5
MIME-Version: 1.0
To: ietf-http-wg@w3.org
References: <5C8F5647-EC0C-4EE2-81AF-8B1F340E3D24@mnot.net>
In-Reply-To: <5C8F5647-EC0C-4EE2-81AF-8B1F340E3D24@mnot.net>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Received-SPF: pass client-ip=58.28.153.233; envelope-from=squid3@treenet.co.nz; helo=treenet.co.nz
X-W3C-Hub-Spam-Status: No, score=-2.5
X-W3C-Hub-Spam-Report: AWL=-2.529, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001
X-W3C-Scan-Sig: maggie.w3.org 1UTkC9-00050z-Aw 438bc4178de82d8baf60cc38c4f79210
X-Original-To: ietf-http-wg@w3.org
Subject: Re: p2: Purely editorial feedback
Archived-At: <http://www.w3.org/mid/5173516A.8000807@treenet.co.nz>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/17444
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <http://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

On 20/04/2013 7:39 p.m., Mark Nottingham wrote:
> Strictly editorial feedback on the current p2:
>
> * 1. Introduction doesn't read smoothly. I'm happy to make a proposal if necessary.
>
> * 2 "The target of each HTTP request"   s/each/a/
>
> * 3.1 "The following header fields are defined to convey representation metadata:"  This reads as if it's a closed set. Suggest removing "are defined to".
>
> * 3.1.1 a more appropriate section title would be "Processing Representation Data" or "Processing Representation Metadata" (depending on intent)
>
> * 3.1.2.1 "Frequently, the representation is stored in coded form, transmitted directly, and only decoded by the recipient."   Saying "final recipient" would be clearer.

But incorect. Encoded from responses are routinely decoded by 
intermediary proxies for processing (think AV scanners on gzipped 
objects). They fall under "recipient", but not "final recipient".

Amos