Daily Archives: October 17, 2004

Writting documentation [revisited]

A few days ago I have mentioned my ramblings on document generation tools. After trying the solutions described in the post (except the solution suggested by Andreas Mecky and Matt Raible, not because I do not like it, but I am still waiting for the Eclipse plugin), this morning (in fact an hour ago) I have started to write down my proposal for document generation solution. A few minutes later I was disturbed by the sound of my mail notification: a comment was just posted on this blog. Subject: Generating project documentation. Suggested solution: Apache Forrest. So I saved the few lines I have just written, fired Firefox and here it goes: Apache Forrest. I few minutes later a demo site was generated automatically by Forrest. , which did in background some interesting stuff (created the documentation directory structure, copied some document templates and a skin and voila!).
A quick look in the internals of Apache Forrest revealed that it uses xdoc as page sources (it even gives you some DTDs), offers an Ant build file (damn this is nice [smile/]) and includes some site templates which are quite clean. The first two arguments are encouraging me to continue investigating (they are according to my goal – but about this I will write in the Writting documentation [final] later). I have to pass again over all my requirements and see how Apache Forrest behaves, but for the beginning I must say I am quite satisfied (even more than satisfied [smile/], and so I was joking about disturbing: thank you very much Anonymous for your suggestion. Please come back to see what’s happening next [blink/]).
Unfortunately this will make me be a little late with the first public release of the new and cool rjxconfig tool, but be sure that when I figure all about generating site documentation it will be here!


1 Comment

Filed under Tools