W3C home > Mailing lists > Public > public-html@w3.org > January 2010

Re: New split-out drafts

From: Karl Dubost <karl+w3c@la-grange.net>
Date: Sun, 10 Jan 2010 09:03:31 -0500
Message-Id: <569CA7B9-ACC9-4110-B10B-C34C79EA68C6@la-grange.net>
Cc: HTML WG Public List <public-html@w3.org>
To: James Graham <jgraham@opera.com>

Le 9 janv. 2010 à 18:38, James Graham a écrit :
> I typically look things up in the single page version of the spec since this makes searching and cross-referencing easier.

fair enough, understandable from a developer usability point of view (access to information)

> 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

Not if you consider the evolution of the individual documents. Let's put aside the usability issue for a while, and let's think only in terms of technology. Having small individual pieces which are orthogonal in design helps to move forward a technology. Let's say that Canvas 3D gets a lot of traction, it will be cool to be able to republish only this part of the technology and not having to publish everything again.

Two other minor considerations:

* usability for translators.
  It's a lot easier to translate small documents and much more rewarding. 
* usability for beginners.
  The full document right now looks like a monster and some people are discouraged just by the volume.

Karl Dubost
Montréal, QC, Canada
Received on Sunday, 10 January 2010 14:03:47 UTC

This archive was generated by hypermail 2.4.0 : Saturday, 9 October 2021 18:45:07 UTC