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.
Sergiu