Skip to content

docs(readme): lead with v1.8, retire the v1.6 spotlight#214

Merged
DemchaAV merged 2 commits into
developfrom
docs/readme-v1.8-refresh
Jun 18, 2026
Merged

docs(readme): lead with v1.8, retire the v1.6 spotlight#214
DemchaAV merged 2 commits into
developfrom
docs/readme-v1.8-refresh

Conversation

@DemchaAV

Copy link
Copy Markdown
Owner

Why

The README still centred on v1.6 — the v1.8 "illustrative" capabilities (native vector charts, SVG import, gradients) were buried in one overlong release-status sentence, so the landing page lagged the engine.

What

  • Release status trimmed to a one-liner that links to a new section.
  • New "What's new in v1.8" — chart preview image + capability bullets (charts, SVG, gradients & clipping, block alignment, keepTogether()), the fonts consumption change, and the ConfigLoader removal stated up front.
  • v1.6 primitives in 30 linesv1.8 primitives in 30 lines — native chart, overshoot-free MONOTONE line, SVG import + block alignment. Snippets lifted from the runnable examples (ChartShowcaseExample, BlockAlignExample), not invented.
  • iText 7 comparison row corrected — it has a high-level object/layout API, not just "manual + helpers".
  • "Cinematic by default" kept as the brand line but grounded with the new primitives.

Removes the What's in v1.6 release-history block (it lives in the CHANGELOG).

Tests

  • Doc-guard suite green: DocumentationCoverageTest, CanonicalSurfaceGuardTest, DocumentationExamplesTest, VersionConsistencyGuardTest — 31 tests, 0 failures.
  • New image (assets/readme/chart-showcase.png), migration link, and the #whats-new-in-v18 anchor all verified to resolve.

DemchaAV added 2 commits June 18, 2026 14:32
The README still centred on v1.6 while the v1.8 'illustrative' work
(native charts, SVG, gradients) was buried in a single overlong
release-status sentence, so the landing page lagged the engine.

- Shrink the Release-status blurb to a one-liner that links to a new
  'What's new in v1.8' section (chart preview + capability bullets,
  the fonts consumption change, and the ConfigLoader removal).
- Replace 'What's in v1.6' / 'v1.6 primitives in 30 lines' with
  'v1.8 primitives in 30 lines' — native chart, overshoot-free line,
  SVG import + block alignment, all lifted from runnable examples.
- Correct the iText 7 comparison row: it has a high-level layout API,
  not just 'manual + helpers'.
- Keep 'Cinematic by default' but ground it with the new primitives.
@DemchaAV DemchaAV merged commit dfd587a into develop Jun 18, 2026
11 checks passed
@DemchaAV DemchaAV deleted the docs/readme-v1.8-refresh branch June 18, 2026 13:58
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