Plugin self-documentation mechanism

[curtis]

To complement an improved plugins infrastructure, it would be nice to have a way for plugin authors to document what their plugin does from an end-user perspective, including the meaning of various parameters.

The idea would be to use Java annotations, Javadoc or something similar, possibly embedded in the source code itself, or possibly in a standard format in some external text file, to document the plugin.

We have attempted this sort of documentation informally with the  Bio-Formats Importer plugin (see attachment) but it would be better to have an official, more structured solution, encouraging plugin authors to document plugin parameters and features by making it very easy to do so.

[curtis]

Inline documentation for the Bio-Formats Importer plugin