Skip to content

fix(docs): let the hero copy be read - #98

Merged
ajbarea merged 1 commit into
mainfrom
fix/hero-legibility
Sep 20, 2026
Merged

ajbarea merged 1 commit into
mainfrom
fix/hero-legibility

Conversation

@ajbarea

@ajbarea ajbarea commented Sep 20, 2026

Copy link
Copy Markdown
Owner

Three things were fighting the reader on the landing page.

The tagline was a full sentence in uppercase. "FEDERATED LEARNING ON THE LATEST FLOWER, WITH OPENTELEMETRY-NATIVE OBSERVABILITY" across two lines. Caps slow reading down because they remove the word shapes we recognise, and here they were standing in for presence that font size can supply directly. Now sentence case, larger, with a real line-height.

The mode strip did the same to a list of facts. flwr 1.36 Message API | federated LoRA | OTel traces + metrics is information, not a label, so it reads as information now.

The wordmark had nothing behind it. The dark scheme's radial is transparent 10% at the centre by design, and the vertical veil did not reach density until 75% down — but the copy begins around the midline. So "Phalanx" sat directly on the busiest part of the mandala. The veil now thickens through the band the copy actually occupies, and stops short of the artwork's top arc, which was never the problem.

zensical 0.0.32 -> 0.0.63. That was the fleet's most stale docs pin by a wide margin, 31 releases behind, hidden behind an unpinned specifier.

Verification

  • Built locally and checked both schemes at 1440px: wordmark, tagline and mode strip all read, and the mandala's upper structure is untouched.
  • zensical build --clean — "No issues found".

Not in this PR

The artwork itself is still symmetric, which forces centred type and leaves no clean ground for a left-aligned column. Replacing it with an asymmetric image is a separate change, since new CSS against the current symmetric art would look worse rather than better.

Three things were fighting the reader. The tagline set a full sentence in
uppercase, which is slower to read and was standing in for presence that
size supplies directly; it is now sentence case and larger. The mode strip
did the same to a list of plain facts. And the dark scheme's radial went
fully transparent at the centre while the vertical veil did not reach
density until 75% down, so the wordmark sat on the busiest part of the
mandala with nothing behind it.

The veil now thickens through the band the copy occupies and leaves the
artwork's top arc alone. zensical 0.0.32 -> 0.0.63, the fleet's most stale
docs pin by a wide margin.
@ajbarea ajbarea added the documentation Improvements or additions to documentation label Sep 20, 2026
@ajbarea ajbarea self-assigned this Sep 20, 2026
@ajbarea
ajbarea enabled auto-merge (squash) September 20, 2026 08:30
@ajbarea
ajbarea merged commit 1932863 into main Sep 20, 2026
12 checks passed
@ajbarea
ajbarea deleted the fix/hero-legibility branch September 20, 2026 08:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant