Automation != docs in a repo. What it means is using a format that carries semantic information about the content. Such a format could easily be on a server that allows editing of the pages. Wiki's are just one type of web page that can be edited.
On Tue, Aug 14, 2012 at 11:10 AM, Mark Callow <email@example.com> wrote:
I don't think enabling trivial modifications at the expense of creating an immense amount of manual labor is the right trade-off.On 12/08/13 19:15, Benoit Jacob wrote:On the one hand, we have markup language that make it easy to write documents. On the other hand we have XML which gives automation but is a pain to write by hand. The only document writing system that combines convenient markup with good large-document-structuration-and-automation features, that I know of, is LaTeX. From the looks of the OpenGL [ES] PDF spec, it seems that it's made in LaTeX, for example (maybe someone can confirm). But compared to a wiki, this will increase the barrier to entry quite a bit.
The point of the pages is as information, not automation. Sure automation might save some work but as has been demonstrated with not only the OpenGL and OpenGL ES man pages but also with just about every other project that has docs in a repo vs a wiki, making it easier to edit leads to more and better info.
NOTE: This electronic mail message may contain confidential and privileged information from HI Corporation. If you are not the intended recipient, any disclosure, photocopying, distribution or use of the contents of the received information is prohibited. If you have received this e-mail in error, please notify the sender immediately and permanently delete this message and all related copies.