Context
The marketing site (byte5ai/omadia-homepage) hero is now business-led: the primary CTA is the pilot, and developers are routed to this repo through a "View on GitHub" secondary CTA. That makes this README the dev-first entry point. For the hand-off to land, a developer who arrives looking for setup should reach the install command fast.
Problem
The top of the README currently reads:
- one-line intro
- 🎬 The 2-minute pitch (video)
- Prerequisites
- ⚡ Quickstart (
docker compose up -d)
A developer who came for setup instructions has to scroll past a video to get to the command. Developers looking for setup instructions do not want to watch a video first.
Change (pure reordering, no copy rewrite)
Hoist Prerequisites and ⚡ Quickstart above 🎬 The 2-minute pitch. Keep the bold one-line intro at the very top (it is the identity statement). Suggested order:
- Header (wordmark, tagline, badges, nav links) — unchanged
- One-line intro paragraph — unchanged
- Prerequisites
- ⚡ Quickstart (
git clone … && docker compose up -d)
- 🎬 The 2-minute pitch (now right after the command: read it, then watch it run)
- 🚀 First run → Why omadia → …
The video keeps its place in the narrative, just after the command rather than before it.
Out of scope
No changes to the section contents themselves. Keep the current voice (the README is free of em-dashes and negation-reveal hooks; keep it that way).
Related
Context
The marketing site (
byte5ai/omadia-homepage) hero is now business-led: the primary CTA is the pilot, and developers are routed to this repo through a "View on GitHub" secondary CTA. That makes this README the dev-first entry point. For the hand-off to land, a developer who arrives looking for setup should reach the install command fast.Problem
The top of the README currently reads:
docker compose up -d)A developer who came for setup instructions has to scroll past a video to get to the command. Developers looking for setup instructions do not want to watch a video first.
Change (pure reordering, no copy rewrite)
Hoist Prerequisites and ⚡ Quickstart above 🎬 The 2-minute pitch. Keep the bold one-line intro at the very top (it is the identity statement). Suggested order:
git clone … && docker compose up -d)The video keeps its place in the narrative, just after the command rather than before it.
Out of scope
No changes to the section contents themselves. Keep the current voice (the README is free of em-dashes and negation-reveal hooks; keep it that way).
Related
byte5ai/omadia-homepage#41(site = business-first, README = dev-first).