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 http://www.la-grange.net/karl/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