Skip to content

fix(hero): describe the real cover height instead of "full page" - #134

Merged
markdumay merged 1 commit into
mainfrom
docs/hero-cover-height
Aug 2, 2026
Merged

fix(hero): describe the real cover height instead of "full page"#134
markdumay merged 1 commit into
mainfrom
docs/hero-cover-height

Conversation

@markdumay

Copy link
Copy Markdown
Contributor

Part of the fix for gethinode/hinode#2107, where a user reported cover: true as a bug because the docs promised more than the theme delivers.

Problem

Two claims in content/blocks/hero.md overstated cover:

  • L16 — "Set cover to true to display a full-page hero."
  • L35 — "You can set cover to true to display a full-height hero."

A cover section is 88vh, capped at 1024px from xxl upwards. The deliberate 12vh peek reads as a bug when the docs say "full page".

Change

  • State the actual height, explain why it stops short of the viewport, and point at main.sectionHeight / main.maxSectionHeight.
  • Correct the illustrated-hero paragraph. cover does not stretch the illustration — it keeps a tall one inside its column so it can't push the hero past the cover height, and leaves landscape images alone (their width is already the limiting dimension under object-fit: contain). Verified by measurement, not by reading the SCSS.

The config link uses an absolute https://gethinode.com/... URL, matching content/components/image.md:130 — a root-relative link fails Hinode's internal link validation when these pages render in the Hinode exampleSite, which the build caught.

Typed fix rather than docs so it releases and gethinode.com can pick it up.

Builds clean in the Hinode exampleSite; markdownlint passes.

Related

🤖 Generated with Claude Code

The hero docs promised a "full-page hero" and a "full-height hero" for
`cover: true`. A cover section is 88vh, capped at 1024px from the xxl
breakpoint upwards, so both claims overstated it and left readers
treating the deliberate 12vh peek as a bug.

State the actual height, explain why it falls short of the viewport, and
point at the `main.sectionHeight` and `main.maxSectionHeight` settings
that change it. Also correct the illustrated-hero paragraph: `cover`
keeps a tall illustration inside its column rather than stretching it,
and leaves landscape illustrations alone.

Refs: gethinode/hinode#2107

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@markdumay
markdumay merged commit 0b882c1 into main Aug 2, 2026
8 checks passed
@markdumay

Copy link
Copy Markdown
Contributor Author

🎉 This PR is included in version 1.15.7 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@markdumay
markdumay deleted the docs/hero-cover-height branch August 2, 2026 06:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant