Skip to content

Commit f2643c2

Browse files
committed
Say what the third number is for
It is not a build counter but the number of fixes that leave the output alone: a crash, a regression, an internal bug, a dependency update. The line between it and the second number is the output, not the kind of change: a fix that changes the output raises the second, a fix that does not raises the third.
1 parent 6956c9b commit f2643c2

1 file changed

Lines changed: 7 additions & 4 deletions

File tree

‎docs/about.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,15 @@ A version is three numbers, `<java>.<minor>.<build>`, and each one answers a que
2525

2626
- **The first is the Java version the formatter is built for**, 21 today. It moves when the minimum
2727
Java version moves.
28-
- **The second counts changes to the output**: a fix in wrapping or alignment, a new
28+
- **The second moves with every change to the output**: a fix in wrapping or alignment, a new
2929
[library rule](library-rules/index.md), a new feature. A newer minor version can reformat code
3030
that the previous one left alone, so take it with one reformatting run, in a commit of its own.
31-
- **The third counts builds that leave the output alone**: regressions, internal bugs, dependency
32-
and build updates. A newer build formats every file exactly as the previous one did, so it is
33-
safe to take at any time.
31+
- **The third moves with fixes that leave the output alone**: a crash, a regression, an internal
32+
bug, a dependency update. A newer build formats every file exactly as the previous one did, so
33+
it is safe to take at any time.
34+
35+
The line between the last two numbers is the output, not the kind of change: a fix that changes
36+
the output raises the second number, a fix that does not raises the third.
3437

3538
Up to 2.98.0.6 the version was palantir-java-format's with a build number appended: 2.98.0.6 is the
3639
sixth build of 2.98.0. Once the bug fixes made the output differ from upstream, that numbering lost

0 commit comments

Comments
 (0)