W3C home > Mailing lists > Public > www-talk@w3.org > January to February 2009

Re: [xri] host-meta comments

From: Breno de Medeiros <breno@google.com>
Date: Thu, 19 Feb 2009 18:38:20 -0800
Message-ID: <29fb00360902191838v3712d43cta2737870c59d6ba7@mail.gmail.com>
To: Mark Nottingham <mnot@yahoo-inc.com>
Cc: Dirk Balfanz <balfanz@google.com>, Apps Discuss <discuss@apps.ietf.org>, Eran Hammer-Lahav <eran@hueniverse.com>, "xri@lists.oasis-open.org" <xri@lists.oasis-open.org>, "www-talk@w3.org" <www-talk@w3.org>
Good point. Sounds good to me.

On Thu, Feb 19, 2009 at 4:00 PM, Mark Nottingham <mnot@yahoo-inc.com> wrote:

>
> The problem is that this will make it impossible to use an existing HTTP
> header parser (e.g., in Python, Perl, Ruby, whatever's standard library), a
> goal that's guided a lot of the design.
>
> Why not just use
>
> Link: </foo>; rel="something"
> Comment: This one is for you, Joe!
> Link </bar>; rel="joes-link"
>
> ?
>
>
>
> On 19/02/2009, at 3:54 AM, Dirk Balfanz wrote:
>
>
>>
>> On Wed, Feb 18, 2009 at 8:23 AM, Breno de Medeiros <breno@google.com>
>> wrote:
>> While /host-meta is intended to be parsed by machines and not
>> human-readable content, it is often the case that users eyeball such content
>> for clues. For instance:
>>
>> 1. Developer is writing and debugging a library to parse host-meta files.
>> 2. Developer is looking at /host-meta examples to get clues on how to
>> write one for his site.
>>
>> Being able to add human-readable comments on site-meta can be useful for
>> such tasks. It also helps to preserve 'institutional memory' by
>> documentation in place, which is often the only one that developers can
>> locate.
>>
>> Should there be a simple mechanism for line comments in site-meta?
>>
>> +1 for comments.
>>
>> I propose that any line that starts with # (possibly preceded by
>> whitespace) is a comment.
>>
>> Dirk.
>>
>
>
> --
> Mark Nottingham       mnot@yahoo-inc.com
>
>
>


-- 
--Breno

+1 (650) 214-1007 desk
+1 (408) 212-0135 (Grand Central)
MTV-41-3 : 383-A
PST (GMT-8) / PDT(GMT-7)
Received on Friday, 20 February 2009 02:38:59 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 27 October 2010 18:14:30 GMT