It sound good for me. Do you know whether their site is generated with this tool ? I want to see how such generated documentation actually looks like.
On Sun, Aug 21, 2011 at 4:01 PM, Martijn Dashorst <[email protected]> wrote: > 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 > -- Martin Grigorov jWeekend Training, Consulting, Development http://jWeekend.com
