docs(installation): badge the "Choose your release line" picker table#62
Merged
Conversation
The picker table at the top of the installation page showed the coordinate string twice (artifact ID + hardcoded version, e.g. `kr.devslab:easy-paging-spring-boot-starter:4.0.0`). That meant the table needed a manual edit on every patch release — and was the same class of slip that PR #6 / #4 (on the org `.github` profile) and PR #59 (on devslab-examples) just fixed for their version-display surfaces. Replaced the "Use" / "좌표" column with a shields.io Maven Central badge per row, using: - versionPrefix=4 for the SB4 active line — `4.x.y` - versionPrefix=3 for the SB3 maintenance line — `3.x.y` The badges read the latest version directly from Maven Central, so the next patch (4.0.1, 3.0.1, etc.) shows up here without a doc edit. Column header renamed "Use" → "Latest on Maven Central" / "좌표" → "Maven Central 최신" to be honest about the new semantic (the cell is display, not copy-paste). Added a one-line nudge below the table pointing readers at the "Adding the dependency" section for actual copy-paste snippets. NOT changed (intentional, all copy-paste targets): - "Adding the dependency" tabs (Gradle Kotlin/Groovy, Maven) - "Optional — reactive companion artifact" snippet - "Need a different MyBatis line?" snippet - "Staying on Spring Boot 3.3–3.5?" snippet at the bottom A reader who wants to know "what's actually current" reads the badge. A reader who wants to paste the dep into their build file reads the snippet. The two layers don't fight — the snippet's hardcoded version will visually mismatch the badge when it drifts, which is the signal to bump the snippet. index.md Quick install snippet kept as-is for the same reason — it's a copy-paste target. The link from index.md → installation.md surfaces the badged picker table for the "what's current?" question. Follow-up if drift becomes a problem: a CI mismatch check that fails the PR when a snippet's version disagrees with the corresponding badge's source-of-truth (Maven Central latest).
…adges
Matches the simplification just applied to devslab-examples#59.
Before: 
(long label squeezes version text)
After: 
(short default label, version is readable)
The artifact ID is redundant — the picker table's left column already
names the line (`4.x.y` / `3.x.y`) and clicking the badge still lands
on the Maven Central artifact page with the full coordinate visible.
1 task
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The picker table at the top of the installation page showed the coordinate-with-version string twice (e.g. `kr.devslab:easy-paging-spring-boot-starter:4.0.0`) and needed a manual edit on every release. Replaced with shields.io Maven Central badges per row — same pattern just landed on:
What changed
What did NOT change (intentional)
Every copy-paste snippet on the page stays as text with a hardcoded version:
Same for `docs/index.md`'s Quick install block — it's a copy-paste target. The link from there back to the installation page surfaces the badged picker for the "what's current?" question.
Why two layers (badge + text)
Why `versionPrefix` per row
Without the filter, the SB3 maintenance row's badge would jump to the latest `4.x` patch the moment one ships — hiding the maintenance line's actual state. `versionPrefix=3` and `versionPrefix=4` keep the two lines independent.
Test plan