Since the maven plugin runs at at build time and has access to the sources, this is a unique opportunity to extract descriptions of components and parameters from JavaDoc. The @ConfigurationParameter annotation provides for a description, but I always found it inconvenient to maintain the description twice, once in JavaDoc and once in the annotation. uimaFIT currently has no support for component descriptions.
Often, the JavaDoc in uimaFIT components is not added do the parameter variable, but rather to the parameter name constant. So auto-completion in the IDE is use on PARAM_<ctrl-space>, it lists all the parameters along with their explanation.
For this reason, the maven plugin should support looking for parameter documentation not on a field, but rather look for a constant field in the component that starts with PARAM and has as value the name of the field - if such a constant is found, its JavaDoc should be used.