improved comments / javadoc for plugin-improvements