Ivan raised a good point on the Hackathon1 page (where he asks that people don't move his egg documentation out of the egg and into the wiki, because it's a pain to deal with eggs that don't have a copy of their docs in the egg directory itself).
It's good to have the wiki docs, and especially so with Toby's excellent callcc.org site as a search interface. But it doesn't address "local" documentation very well. We've done some work on wiki->texi conversion, which is good, but it's not integrated with chicken-setup in any way, and that's a drawback. One can imagine pushing local docs into the wiki upon releasing a new egg version; or adding an "include" mechanism to the wiki to pull in external docs (though that would make search-indexing harder if not done properly). Since the wiki is stored in the svn repository, there are opportunities for svn-commit hooks to do some of the work, as well as opportunities for a decent inclusion mechanism. Before we venture too far into 'wikifying' all of the egg documentation, if that's a hackathon goal, we should probably ensure that we have a consistent documentation plan that ensures a local copy of the docs is preserved in some form. Personally, I'd love to have texi documentation, and (optionally) have chicken-setup do the necessary work to pull egg docs into the 'info' system. I'd never have to leave Emacs to look something up, and that would (for me) be more efficient than keeping a callcc.org browser open. Graham _______________________________________________ Chicken-users mailing list [email protected] http://lists.nongnu.org/mailman/listinfo/chicken-users
