Revisit published Maven artifact names (artifactId) #3245
Labels
enhancement
An issue for a feature or an overall improvement
tech-debt
A technical issue that is not observable by the users, but improves maintainers quality of life
Tech debt
The Maven artifacts that are currently published by Dokka are somewhat inconsistent:
mathjax-plugin
), a Dokka runner (dokka-maven-plugin
) and an output format (gfm-plugin
), although all of them are plugins in their own right.dokka-
(likedokka-core
anddokka-base
), others are not.dokka-test-api
is in reality test API fordokka-core
, which isn't obvious.dokka-base
needs special treatment, since it's just a Dokka plugin (should it bebase-plugin
instead?)plugin-jekyll-template-processing
are not user friendly, although they are expected to be used in non-Gradle runners for generating multimodule documentation. Should they even be published as a separate artifact? (can probably be bundled with the main format plugin, and enabled conditionally ifall-modules-page
plugin is on classpath)These inconsistencies and the lack of an easy to follow logic in naming leads to problems with perception, and makes it difficult to use Gradle's composite builds (they require the name of the project to be the same as the artifact name).
Proposed solution
The artifact names should be revisited:
This issue came into existence after it started getting in the way of #3174. Temporary workarounds have been put in place until this issue is resolved.
The text was updated successfully, but these errors were encountered: