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

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

Requirement: Hero source link remains available as secondary action

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

Scenario: Source link navigates externally

• 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, including Tamil and Malayalam rendering paths.

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
• AND readability remains stable for English, Tamil, and Malayalam content

Scenario: Mobile viewport readability

• WHEN the hero renders on a mobile viewport
• THEN metadata and title remain readable without overlapping controls or clipping
• AND Tamil and Malayalam typography remains legible at mobile breakpoints