rmannibucau commented on code in PR #1145:
URL: https://github.com/apache/maven/pull/1145#discussion_r1221145499
##########
maven-plugin-api/src/main/mdo/plugin.mdo:
##########
@@ -24,9 +24,10 @@ under the License.
<description><![CDATA[
Plugin descriptor, stored in <code>META-INF/maven/plugin.xml</code> in a
plugin's jar artifact.
This descriptor is generally generated from plugin sources, using
- <a href="/plugins/maven-plugin-plugin/">maven-plugin-plugin</a>.
- <p><i>Notice:</i> this documentation is generated from a Modello model but
the code executed is not generated
- from this descriptor. Please report if you find anything wrong.</p>
+ <a href="/plugins/maven-plugin-plugin/">maven-plugin-plugin</a>, but other
tools may geenrated it or it could even be hand-written.
Review Comment:
It happens the file is written manually and it is regularly parsed by other
tools (rarely generated I guess, it is either the official generator or
manually done).
But this is a public API since it is part of the contract of plugins, the
tools don't encapsulate anything while it must be published IMHO so structure
has to be stable even if it can evolve (additions and things like that are ok
for ex for such cases).
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
