Update documentations on snapshots

[cortinico]

I'm updating the documentation around using SNAPSHOTS as it was lacking.

Moreover I'm updating the SNAPSHOT name to be master-SNAPSHOT. If we don't like it we could use the upcoming version (but that forces us to keep two versions number updated).

[BraisGabin]

👏🏻👏🏻👏🏻👏🏻 Nice one! And I like the master-SNAPSHOT name.

[codecov]

Codecov Report

Merging #3393 (cf2abc1) into master (1164c34) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##             master    #3393   +/-   ##
=========================================
  Coverage     80.40%   80.40%           
  Complexity     2745     2745           
=========================================
  Files           448      448           
  Lines          8279     8279           
  Branches       1582     1582           
=========================================
  Hits           6657     6657           
  Misses          767      767           
  Partials        855      855           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1164c34...09b622b. Read the comment docs.

[chao2zhang]

I have one question if you may know the answer to.

[chao2zhang]

I came to read https://docs.gradle.org/current/userguide/plugins.html#sec:plugin_markers. I am wondering why we don't publish a Gradle Plugin marker in our build?

[cortinico]

The reason is here:

detekt/detekt-gradle-plugin/build.gradle.kts

Lines 58 to 60 in 1164c34

	// hack to prevent building two jar's overwriting each other and leading to invalid signatures
	// when publishing the Gradle plugin, this property must be present
	isAutomatedPublishing = System.getProperty("automatePublishing")?.toBoolean() ?: false

I'm unsure of what was the exact issue with isAutomatedPublishing and the invalid signature, but we can definitely look into it.