Files
clawfort/openspec/specs/hero-summary-entry-and-readability/spec.md

1.4 KiB

Purpose

Canonical specification for hero-summary-entry-and-readability requirements synced from OpenSpec change deltas.

Requirements

Requirement: Hero primary action opens in-site TL;DR summary

The homepage hero primary CTA SHALL open the in-site summary modal for the hero article instead of navigating off-site.

Scenario: Hero CTA opens summary modal

  • WHEN a user clicks the hero primary CTA
  • THEN the system opens the summary modal for the current hero article
  • AND no external navigation is triggered by that CTA

The hero section SHALL keep an explicit secondary source-link action for external navigation.

  • WHEN a user clicks the hero source link
  • THEN the system opens the article source URL in a new tab

Requirement: Hero metadata readability over images

Hero metadata (LATEST, relative time, headline, and summary) SHALL remain visually legible across bright and dark images on desktop and mobile.

Scenario: Bright image background

  • WHEN the hero image contains bright regions under metadata text
  • THEN overlay and text styles preserve readable contrast for metadata and headline blocks

Scenario: Mobile viewport readability

  • WHEN the hero renders on a mobile viewport
  • THEN metadata and title remain readable without overlapping controls or clipping