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

Re: [xri] host-meta comments

From: Dirk Balfanz <balfanz@google.com>
Date: Wed, 18 Feb 2009 08:54:48 -0800
Message-ID: <60c552b80902180854j5b9ecf1ck9da84e11ef782fa9@mail.gmail.com>
To: Breno de Medeiros <breno@google.com>
Cc: 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>
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.


>
> --
> --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 Wednesday, 18 February 2009 16:55:26 GMT

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