docs: bring the release-facing surfaces up to 2.1 - #449
Closed
DemchaAV wants to merge 1 commit into
Closed
Conversation
The three pages a visitor reaches before any code still described an earlier release. README's stable-release banner and the security policy's supported- versions table both name the current line; the table had stayed on 1.9.x across two majors while the policy above it already said fixes go to the latest minor. The showcase site never mentioned PowerPoint at all, though its gallery has been serving decks since the twin examples landed. It also told visitors to call BusinessTheme.modern(), which ships only in the unpublished examples module — the README has said that type is gone since 2.0, so the two public faces disagreed. Preset counts were three short in one place and claimed fourteen entries over a list of five in another, and the test-count claim is replaced with the gate it stands for so it cannot go stale again.
DemchaAV
commented
Jul 26, 2026
OwnerAuthor
Superseded by #450, which was branched from this branch and carried all three files with it. |
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 freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Why
Three pages a visitor reaches before they ever see code, all describing an earlier release. None is rewritten by
cut-release.ps1— the script owns version tokens (poms, install snippets, the hero badge, JSON-LDsoftwareVersion), and every claim below is prose it deliberately leaves alone.README
The stable-release banner named v2.0.0 and its module split. It now names v2.1.0 and what the release is actually about, pointing at the capability matrix instead of the 2.0 migration guide — which the README still links from six other places, so nothing is lost.
SECURITY.md
The supported-versions table said
1.9.x— actively patched. It had stayed there across two majors, while the sentence directly above it says fixes go to the latest minor release. The table said one thing and the policy said another.The showcase site
PowerPoint appeared nowhere on it — zero mentions — even though the gallery has been serving decks since the twin examples landed, and five cards already render a "Get PPTX" button from the manifest. The hero, the pipeline description, and the JSON-LD
featureListall described a PDF-only engine.It told visitors to call an API they cannot obtain.
BusinessTheme.modern()appeared in the feature grid and in the JSON-LD feature list. That type ships only in theexamplesmodule, which is not published — and README.md:96 has stated since 2.0 thatBusinessThemeis gone and names its replacement. The project's two public faces contradicted each other on the theming entry point. Replaced with the real one,BrandThemefromgraph-compose-templates, using factories that exist.Counts:
MinimalUnderlinedhas none)<noscript>list of five entriesThe two
<noscript>headers now describe the selection they head instead of claiming a catalogue total, and the test count is replaced by the gate it stood for so it cannot rot again.50+ runnable examplesis left as-is — the manifest carries 87, so it is true and conservative.Deliberately not changed
The page
<title>,<h1>, and<meta name="description">still read "Java PDF layout engine". PDF is the production backend and PPTX ships@Beta, so the one-line positioning is a maintainer call rather than a correctness fix — same reason the GitHub repository description and topics are untouched.Verification
./mvnw -B -ntp clean verifyover the eight-module reactor — BUILD SUCCESS, 0 failures,VersionConsistencyGuardTestgreen (12 tests). Site served locally and re-read after the edits: no console errors, every one of the 39showcase/links resolves on disk, no stale string survives in the rendered DOM, PPTX now appears 9 times, and the 5 "Get PPTX" gallery buttons match the 5 manifest entries.