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

[Paul Hoffman <[e-mail]>]

On Jan 27, 2012, at 10: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.


...except when it excludes the reasoning for the text.

As you say before, the document doesn't directly address the misuse of parameters, although it hints at it. If you think only hinting is useful (I don't), then not even hinting at why the document only covers names is probably fine.

I really think you are undershooting here.

--Paul Hoffman