6 Feb
2008
6 Feb
'08
5:59 p.m.
Hi Sergiu,
On Feb 6, 2008, at 5:42 PM, Sergiu Dumitriu wrote:
Hi,
I think it would be better to publish the plugin API javadoc on the
XWiki site, instead of manually putting some pseudo java interface
in a
{code} block. We do the same for the platform-core, by uploading the
generated javadoc jar and using the zipexplorer plugin to show the
index
page.
I agree.
Several things:
1) This is not meant to be the javadoc. It's simply because lots (if
not the great majority) ofl XWiki developers don't care about
documentation and they never bother to create it. Thus I'm finding
myself forced to document it for them when the release time comes. And
since I don't have 3 days to document everyone's else code, I've just
quickly copy-pasted some interfaces to ensure we've got something to
document... In real I'd like to have a short tutorial on the
capabilities of the plugin, some examples about using it, etc.
2) I agree about the javadoc. We need this. Right now it's too much of
a pain to do so we need to do some automation before this can become a
real way of doing it. In particular I think we need to write some
maven plugin that will do several things:
A) deploy the plugin in the download section
B) deploy the javadoc and link it
C) Create a blog post to announce the release
etc
Thanks
-Vincent