Re: New split-out drafts

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