All, One of the things that has been bothering me (us?) is the lack of a reference manual available from our own website. The biggest issues that plagues me in starting to develop one are: - docbook: reading, writing and maintaining XML is a drag - impossible to keep up to date: very hard to maintain on our open source budget (examples get out of date, code doesn't compile etc)
I discussed this at some conference with Dan Allen from Seam and he pointed me to Lemma: http://teleal.org/projects/lemma Lemma is a documentation generator from JavaDoc and example source code. This way we should be able to leverage wicket examples and our unit tests to generate a reference manual. It would be more maintainable (example code gets refactored, etc). Now before we start using it (it has a AGPL license, not sure how that pans out), I'd like to ask if this is something we would like to use—apart from the license. If so, I'll ask legal@ if this is usable at Apache and start an experiment. Another option would be to use pandoc to generate a manual from markdown, but then we run the risk of out-of-date examples. Martijn -- Become a Wicket expert, learn from the best: http://wicketinaction.com
