Skip to content

docs(release): prep v1.6.8 — feature summary + migration table (PR-1.6.8)#122

Merged
DemchaAV merged 1 commit into
developfrom
docs/release-1.6.8-prep
Jun 1, 2026
Merged

docs(release): prep v1.6.8 — feature summary + migration table (PR-1.6.8)#122
DemchaAV merged 1 commit into
developfrom
docs/release-1.6.8-prep

Conversation

@DemchaAV
Copy link
Copy Markdown
Owner

@DemchaAV DemchaAV commented Jun 1, 2026

Summary

Final pre-cut PR for the v1.6.8 cycle. Replaces the placeholder
"Scope being assembled" intro on the v1.6.8 — Planned CHANGELOG
entry with a three-paragraph release summary (what shipped /
zero-breaking status / migration), mirroring the structure of
#114 (v1.6.7
release-prep) and #100
(v1.6.6 release-prep).

What this PR adds to CHANGELOG

  • Three-paragraph prose summary for v1.6.8 — Planned: the
    headline (CV v2 hyperlink-aware project titles + 4 contemporary
    BusinessTheme presets + senior-review polish), japicmp
    verdict (semver PATCH across every PR in the cycle), and a
    migration table.
  • Migration callout for the one semantic shift surfaced by
    the senior review during the M3 wiring: ProjectLabel.parse
    no longer strips inline Markdown from title(). Callers that
    need the legacy plain-text projection can wrap with
    MarkdownInline.plainText(title), or route through the
    MarkdownInline.append path that ProjectRenderer itself
    now uses to get emphasis / link rendering "for free".

What this PR does NOT touch

  • README release-status block + install snippets. Already in
    the right shape from the post-1.6.7 commit (9e47443f):
    latest stable v1.6.7 / in develop v1.6.8 / planned v1.7.0.
    The 1.6.71.6.8 version flip in install snippets is
    the job of scripts/cut-release.ps1 at cut time.
  • pom.xml versions. Same — bumped atomically by
    cut-release.ps1 against the aggregator.

What's in v1.6.8 (PR list since the v1.6.7 cut)

PR Track Skoпe
#116 N2-prep Testing-quickstart doc
#117 J1+sync Dependabot target-branch fix + deps sync (logback 1.5.34 CVE)
#118 Themes 4 contemporary BusinessTheme presets
#119 M1 MarkdownInline [label](url) parser
#120 M3 ProjectRenderer + ProjectLabel hyperlink wiring
#121 J2+J3+J4 Senior-review polish bundle

After this PR merges

The v1.6.8 cut runs through the graphcompose-release-engineer
skill:

  1. scripts/cut-release.ps1 -Version 1.6.8 — atomic version bump
    across all four poms, flips JitPack snippet to v1.6.8, dates
    the CHANGELOG, runs verify, tags v1.6.8, pushes.
  2. release.yml creates the GitHub Release from the tag.
  3. publish.yml re-runs verify at the tagged commit and uploads
    to Maven Central (Central secrets are wired from v1.6.6 cut).
  4. javadoc.io auto-mirrors within minutes.
  5. Post-release commit on develop: flip japicmp baseline
    v1.6.7 → v1.6.8, add v1.6.9 / v1.7.0 — Planned stub.

Test plan

  • ./mvnw test -pl . -Dtest=VersionConsistencyGuardTest,DocumentationCoverageTest,DocumentationExamplesTest
    22 tests, 0 failures.
  • Full ./mvnw verify -P japicmp was green at 31cacc70
    (the J-bundle merge that closed the feature scope). This
    PR touches only CHANGELOG.md prose, so no source/binary
    surface change.

…6.8)

Final pre-cut PR for v1.6.8. Replaces the placeholder "Scope being
assembled" intro with a three-paragraph release summary (what
shipped / zero-breaking status / migration), mirroring the
structure of v1.6.7 release-prep (#114) and v1.6.6 release-prep
(#100).

Headline narrative: CV v2 migration completion (hyperlink-aware
project / entry titles via [label](url) inline-Markdown) + four
contemporary BusinessTheme presets (nordic/editorial/cinematic/
monochrome) + senior-review follow-ups (registry entry-point
symmetry, Dependabot target-branch fix, logback CVE-2026-9828
patch via the deps-sync cherry-pick from #115).

Migration table calls out the one semantic shift that surfaced
via the CvV2ComponentUtilityTest pin: ProjectLabel.parse no
longer strips inline-Markdown from title() — callers that need
the legacy plain-text projection can wrap with
MarkdownInline.plainText(title), or route through the
MarkdownInline.append path that ProjectRenderer itself now uses
to get emphasis / link rendering "for free".

README release-status block + install snippets are intentionally
not touched here — the post-release-of-1.6.7 commit (9e47443)
already flipped them to the right pre-1.6.8-cut shape (latest
stable v1.6.7 / in develop v1.6.8 / planned v1.7.0). pom version
flip in install snippets is part of cut-release.ps1 at release
time, not this PR.

Verification: ./mvnw test -pl .
-Dtest=VersionConsistencyGuardTest,DocumentationCoverageTest,DocumentationExamplesTest
- 22 tests, 0 failures. The full ./mvnw verify -P japicmp suite
was green at 31cacc7 (the J-bundle merge that closed the
feature scope) and this PR touches only CHANGELOG prose.
@DemchaAV DemchaAV force-pushed the docs/release-1.6.8-prep branch from e2c9ad5 to 71ef280 Compare June 1, 2026 21:43
@DemchaAV DemchaAV merged commit c1a98aa into develop Jun 1, 2026
11 checks passed
@DemchaAV DemchaAV deleted the docs/release-1.6.8-prep branch June 1, 2026 21:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant