Re: New split-out drafts

On Sat, Jan 9, 2010 at 3:38 PM, James Graham <jgraham@opera.com> wrote:

> My experience is that having a single spec is rather helpful; I typically
> look things up in the single page version of the spec since this makes
> searching and cross-referencing easier. I find the organization of the spec
> into chapters to provide sufficient granularity of concepts and, in cases
> where I am clear what I am looking for, I can look at the relevant chapter
> in the multipage version of the spec so as not to incur the overhead of
> loading the whole document. I have also observed situations in which people
> have misunderstood specs split out from HTML5 because they have failed to
> follow the cross-references when necessary.
>
> It seems to me that, neglecting primarily political concerns, a monolithic
> spec that is well structured and available in both single-page and
> multi-page versions is rather similar to a spec that is split into many
> different documents except in the latter case it is harder to get a single
> document containing all the material one might need to understand the
> HTML/DOM part of the web stack and it is harder to find the right material
> if one doesn't already know where it lives.
>
>
> +1

Received on Sunday, 10 January 2010 00:07:25 UTC