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
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
