[REQ] Configuration options are somewhat confusing

Within the maven plugin configuration you have the potential to have something like this:

<configuration>
   <property1>blah</prope
    <configurationFile>my-config-file-containing-other-properties.json</configurationFile>
    <configOptions>
         <moreProperties>blah blah</moreProperties>
    </configOptions> 
    <additionalProperties>
          <evenMoreProperties>blah blah blah</evenMoreProperties>
    </additionalProperties>
</configuration>

The configurationFile mentions "Path to separate json configuration file" but what options go in this file?
Does the config file override the all the properties? Which has presidence?

This is so confusing! Can we have a clear definition of what the config options/properties should be either in a single file or structure rather than options upon properties upon config files

Either improve the structure or have better naming. Maybe include more examples in the documentation as Ive seen all sorts of different variations

Start with the Maven plugin configuration entry point and the documented configurationFile, configOptions, and additionalProperties options. Review existing examples to determine the accepted JSON contents and precedence rules. Done means the configuration model is simplified or the documentation clearly defines valid options, naming, precedence, and representative examples.