[jira] [Created] (MNG-7609) Clarify documentation of extension descriptor

["Konrad Windszus (Jira)" <ji...@apache.org>]

Konrad Windszus created MNG-7609:
------------------------------------

             Summary: Clarify documentation of extension descriptor
                 Key: MNG-7609
                 URL: https://issues.apache.org/jira/browse/MNG-7609
             Project: Maven
          Issue Type: Improvement
          Components: Core
            Reporter: Konrad Windszus


The extension descriptor is documented in https://maven.apache.org/ref/3-LATEST/maven-core/extension.html based on the MDO file at https://github.com/apache/maven/blob/master/maven-core/src/main/mdo/extension.mdo.
It is lacking important information such as
- how are subpackages and wildcards handled in {{exportedPackages}}?
- how can one export individual classes via {{exportedPackages}} (compare with https://github.com/apache/maven/blob/c6ecff9923088d854d4621e17d602f1c70dda806/maven-core/src/main/mdo/extension.mdo#L50)
- how are {{exportedPackages}} and {{exportedArtifacts}} related? Are they just merged or are they combined in some other way?

The better extension descriptor documentation should finally be linked also from https://github.com/apache/maven/blob/master/maven-core/src/site/apt/core-extensions.apt.vm, as well as from https://maven.apache.org/guides/mini/guide-maven-classloading.html#API_Classloader and https://maven.apache.org/guides/mini/guide-using-extensions.html



--
This message was sent by Atlassian Jira
(v8.20.10#820010)