Claudio:
Thanks for that link! Jsourcery also has something similar, but I think
that their approach uses a custom version of javadoc, which is, I think,
where doclets come in. This would only work, again, where you actually
had access to a source archive, and I think they actually generate and
store their pages.
Another interesting facet is the ability to link to other javadoc sites;
XWiki's API javadoc doesn't link classes from externally packages, which
is not a major problem, but a small one. If an undefined reference came
up, the ability to point to its home would be helpful.
It may be that just using Jdocs would be faster, since they already have
a solution; what do you think? It's not really what I'd like to see,
which would be an almost-transparent pasting of user-edited content as
though it were in the original sources. But this is worlds better than
nothing.
Another idea would use the JDOM API, which could be used in a very
robust server-side solution that could do all that I've thought of here
and probably things I've never even dreamed of.
brain[sic]
-----Original Message-----
From: Claudio Miranda [mailto:claudio@claudius.com.br]
Sent: Thursday, March 16, 2006 11:53 AM
To: xwiki-users(a)objectweb.org
Subject: Re: [xwiki-users] IDEA: API Documentation wiki
Probably JDocs, already to the job of make comments on javadocs.
check it out:
http://www.jdocs.com
[]s
Claudio