32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
## 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.
|
|
|
|
#### 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
|