I don't understand why is everyone trying to come up with the Mother of all Documentation Systems all the time. For the time being, can't we just agree on having two documentation standards for Chicken: wiki (for simple documentation) and eggdoc (for complex documentation with examples, tutorials, etc.). Then we could gradually add eggdoc-like markup to stream-wiki to the point where it would be easy to write a script that automatically converts eggdoc to wiki. Of course, this still doesn't solve the problem with not having the documentation available in the SVN repository. So any automatic operation on the repository, such as building Debian packages for the eggs cannot work without manual intervention. Unless someone has a very clear and detailed idea about to deal with this, I will ask you to defer grandiose ideas about converting all documentation in the world to the ultimate and bestest format.
-Ivan Elf <[EMAIL PROTECTED]> writes: > putting in my two cents (sorry for the delay, i didnt read the list today yet) > ... > i am working on a documentation system to replace eggdocs, straight-wiki, and > chicken-man simultaneously. this is not to say or imply in any way that there > wont be web files on callcc! the goal of the system is to be able to generate > the documentation for chicken in any form, searchable via net or within the > interpreter or as a pdf or texi or WHATEVER, while enforcing some consistency > in presentation. this will (hopefully) make it easier to a) document > both eggs and core, b) keep the documentation up to date, c) reduce > duplication of effort, and d) reduce the learning curve. this is NOT > a replacement for the > wiki, however; certain things can and SHOULD be wikiised. > > a full (semi)formal specification will follow, hopefully later tonight. the > specification is intended as an rfc, not as an elf-says-so-its-set-in-stone, > obviously. > > -elf _______________________________________________ Chicken-users mailing list [email protected] http://lists.nongnu.org/mailman/listinfo/chicken-users
