[Tm4j-developers] Website update (well, sort of)

[Kal A. <ka...@te...>]

Hi all,

I've been updating the TopicMapDoclet code a bit to try and get a useful
approximation of the standard Javadoc out of it. What I have so far I
have integrated into the website build and uploaded. If you go to
http://www.tm4j.org/tm4j-engine.html or
http://www.tm4j.org/x1k1pbb6tr-0.html (hmmm, that needs to be changed
really... :), you will see that the topics for those pages are now
associated with topics for the packages that the application provides
(listed under the header "Contains" in the right-hand bar). Clicking on
one of those takes you into the Javadoc-alike topic map stuff. 

What makes this quite fun is that there is tight integration with the
documentation (see http://www.tm4j.org/dg-N1050D.html - scroll down or
use the left-hand menu to see the related resources) thanks to the topic
map generated from the Developer's Guide docbook source. Also because
the topic maps from the separate projects get merged together, where a
method in Panckoucke uses a class from TM4J, the Javadoc-alike pages are
actually linked together (unlike when you have the standard javadoc
documentation that can only link together all the classes processed in a
single run).

There is still a bit of work to be done in tidying up and I think that
some features of standard Javadoc are still missing, but any thoughts
and comments or suggestions for the layout would be appreciated.

I also want to get a whole bunch of FAQs together and topic map them to
integrate them with the site and class documentation. So any suggestions
for questions (and answers) would also be welcome.

I'll be checking in the changes and the TM4Web/Velocity templates that
made all this happen over the weekend. But right now I need some more
coffee ;-)

Cheers,

Kal 
-- 
Kal Ahmed <ka...@te...>
techquila