Re: [apps-discuss] WGLC on draft-ietf-appsawg-xdash-02.txt

Peter Saint-Andre <stpeter@stpeter.im> Fri, 27 January 2012 18:44 UTC

Return-Path: <stpeter@stpeter.im>
X-Original-To: apps-discuss@ietfa.amsl.com
Delivered-To: apps-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 51DE021F8618 for <apps-discuss@ietfa.amsl.com>; Fri, 27 Jan 2012 10:44:31 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.608
X-Spam-Level:
X-Spam-Status: No, score=-102.608 tagged_above=-999 required=5 tests=[AWL=-0.009, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
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 nEqnFN8btRgg for <apps-discuss@ietfa.amsl.com>; Fri, 27 Jan 2012 10:44:30 -0800 (PST)
Received: from stpeter.im (mailhost.stpeter.im [207.210.219.225]) by ietfa.amsl.com (Postfix) with ESMTP id D48EE21F8604 for <apps-discuss@ietf.org>; Fri, 27 Jan 2012 10:44:30 -0800 (PST)
Received: from dhcp-64-101-72-231.cisco.com (unknown [64.101.72.231]) (Authenticated sender: stpeter) by stpeter.im (Postfix) with ESMTPSA id 5689E4005B; Fri, 27 Jan 2012 11:54:22 -0700 (MST)
Message-ID: <4F22F08D.4060902@stpeter.im>
Date: Fri, 27 Jan 2012 11:44:29 -0700
From: Peter Saint-Andre <stpeter@stpeter.im>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.5; rv:9.0) Gecko/20111222 Thunderbird/9.0.1
MIME-Version: 1.0
To: dcrocker@bbiw.net
References: <4EE2430E.4080501@isode.com> <4F1F1A72.1090302@isode.com> <6068EE9E-D120-4CE9-8096-C296C169C7DE@vpnc.org> <4F22EE3A.9010801@stpeter.im> <4F22EF8B.9000509@dcrocker.net> <4F22EFCF.3050607@stpeter.im>
In-Reply-To: <4F22EFCF.3050607@stpeter.im>
X-Enigmail-Version: 1.3.5
OpenPGP: url=https://stpeter.im/stpeter.asc
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Cc: Paul Hoffman <paul.hoffman@vpnc.org>, "apps-discuss@ietf.org" <apps-discuss@ietf.org>
Subject: Re: [apps-discuss] WGLC on draft-ietf-appsawg-xdash-02.txt
X-BeenThere: apps-discuss@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion of application-layer protocols <apps-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/apps-discuss>
List-Post: <mailto:apps-discuss@ietf.org>
List-Help: <mailto:apps-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 27 Jan 2012 18:44:31 -0000

On 1/27/12 11:41 AM, Peter Saint-Andre wrote:
> On 1/27/12 11:40 AM, Dave CROCKER wrote:
>>
>>
>> On 1/27/2012 10:34 AM, Peter Saint-Andre wrote:
>>> Proposed text is always appreciated.:)
>>>
>>> It's not clear to me what function the third sentence serves; we don't
>>> talk elsewhere about the misuse of parameters. With some editing, I
>>> suggest:
>>>
>>> Because textual names of parameters (e.g., "hash-type" and
>>> "x-hash-type") tend to appear in administrative and user interfaces much
>>> more often than numbers that identify parameters (e.g., 7 or 0xa007),
>>> this document discusses only parameters with textual names, not
>>> parameters that are expressed with numbers.
>>
>>
>> In fact I'm unclear about what problem the added text solves.  It seems
>> to focus on issues that are out of scope for the draft.
>>
>> At best, an aid to the reader to understand that scope seems sufficient,
>> along the lines of Paul's prefatory sentence:
>>
>>      The specification only cover parameter names, not numbers.
> 
> Brevity is good.

I suggest slightly modifying the second paragraph of the introduction:

   Although in theory the "X-" convention was a good way to avoid
   collisions (and attendant interoperability problems) between
   standard parameters and non-standard parameters, in practice the
   benefits have been outweighed by the costs associated with the
   leakage of non-standard parameters into the standards space.
   Therefore this document deprecates the "X-" convention for named
   parameters in application protocols and makes specific
   recommendations about how to proceed in a world without the
   distinction between standard and non-standard parameters.  Note that
   this document covers named parameters only, not numbers.

/psa