On 06-09-29 12:50 -0400, Philip Schuchardt wrote: > Sweet! Awesome documention. To me, it feels like Therion is documented far > better then any other cave mapping software.
That's because everyone who uses it seriously has to write some user-level documentation to help themselves :-) It is indeed a remarkable piece of work Marco - it must have taken weeks! The diagrams are hugely useful. I have only had a quick read, so missed a lot of detail, but I found a number of things that could be fixed/imporved, and some that need discussion about the best way to do things. For the text that is easy to just do, but the pictures are harder to modify without the original source files. It seems to me that this set of docs go a long way to replacing the thbook. I wonder where we should go from here. Currently the thbook is a complete reference to the syntax and a developer reference (with some user-level info), whilst the wiki contains a full 'user guide' plus much (most?) of the reference material. Ideally we could get one set of documentation which contained everything that is known, probably split into 'user guide' and 'reference' and 'developer info' sections. Does anyone have any suggestions for how to keep the benefits of wikified documentation, yet still be able to produce standalone docs in PDF or whatever form? I have used Docbook (SGML, now XML is preferred) to easily produce docs in multiple output forms: (HTML/PDF/DOC etc), but I don't know how to integrate that with wiki markup, or even if it is usefully possible. Somehow having the original exmaple files and diagrams around so they can easily be updated would also be good. Perhaps all we need is a way to generate static html from the wiki docs (for inclusion with therion source/binary/package distribution) and forget about a PDF version? I am interested in helping with such an activity, especially with english grammar improvements and general corrections. What does everyone else think? Wookey -- Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK Tel +44 (0) 1223 811679 work: http://www.aleph1.co.uk/ play: http://wookware.org/
