[RFE][Docs] Publish g:a:v in maven-plugin-documentation

Open
#1,942 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
java
Domain
documentation

Research direction

Start with plugin-maven/README.md and review the existing plugin examples. Document Maven coordinates for every plugin, and include an alternative URL for tools without Maven artifacts; check issue 1922 for the referenced greclipse context. Done means the README exposes coordinates or a usable version URL for each example.

Written by the indexing model from the issue text.

Description

enhancement

This is a recommendation / request for enhancement for https://github.com/diffplug/spotless/blob/main/plugin-maven/README.md.

feature description

Please publish the Maven coordinates for every plugin.
E.g. palantir:

<dependency>
    <groupId>com.palantir.javaformat</groupId>
    <artifactId>palantir-java-format</artifactId>
    <version>2.38.0</version>
</dependency>

use case

Users can easily find new versions

Users can use the coordinates and go to https://search.maven.org/ to see whether there are more recent versions, or older versions if needed.

can be picked up by dependency bots

If you put the above into your dependency management, preferably using a property for the version, tools like renovate or dependabot can update the dependency.
With the current examples, those versions will never be picked up.

can be scanned by security scanners

If you put the above into your dependency management, security scanners will recognise the artefact, too.

versions without Maven artefacts

For tools like greclipse, publish another URL which can be used.
(optional) For greclipse specifically, show the Maven coordinates for the older versions (as mentioned in https://github.com/diffplug/spotless/issues/1922).

Dominant language
Java
Stars
5.7k
Forks
560
Avg merge
1d 13h
Merged PRs (30d)
43

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from diffplug/spotless

All issues in diffplug/spotless

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.