Skip to content

docs: rework README hero — banner, inline pitch video, single Why table#374

Merged
iret77 merged 1 commit into
mainfrom
docs/readme-hero-polish
Jun 28, 2026
Merged

docs: rework README hero — banner, inline pitch video, single Why table#374
iret77 merged 1 commit into
mainfrom
docs/readme-hero-polish

Conversation

@iret77

@iret77 iret77 commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Visual + structure polish on top of #373 (which closed #369), per review feedback that the splash looked too tall/narrow and the pitch video heading rendered without a video.

What changed

  • Hero banner — the 16:9 splash was the wrong shape for a header (too much empty vertical space). Replaced with a cropped 3.5:1 wordmark banner (docs/media/omadia-banner.png). Dropped the redundant # omadia H1 since the banner is the wordmark.
  • Inline pitch video — GitHub does not render <video src=".../raw/...mp4"> inline; only user-attachments asset URLs play inline. Swapped in the GitHub-hosted asset URL so the player actually renders. Removed the now-unreferenced in-repo docs/media/omadia-pitch.mp4 (18 MB) and the old splash PNG.
  • One value block — merged the two competing sections ("Why you'll want to ⭐ this" + "Why omadia?") into a single scannable capability table, differentiators first (Privacy Shield, verification, computed-not-guessed).
  • Demo GIF — moved out of the stacked header into the First run section, where it illustrates the actual flow.

No content claims changed; the differentiator facts were already verified against the code in #369.

Note

The inline video uses the user-attachments asset URL (uploaded via GitHub), which is the only reliable way to get an inline player in a README.

🤖 Generated with Claude Code

Follow-up polish to the #369 README update, addressing visual/structure
feedback:

- Hero: replace the 16:9 splash block (too tall/narrow as a header) with a
  cropped 3.5:1 wordmark banner; drop the redundant `# omadia` H1 (the banner
  is the wordmark)
- Pitch video: the previous `<video src=".../raw/...mp4">` did not render inline
  on GitHub (only user-attachments URLs do). Embed the GitHub-hosted asset URL
  so the player renders inline; remove the now-unreferenced in-repo
  docs/media/omadia-pitch.mp4 (18 MB) and the splash PNG
- Merge the two competing value props ("Why you'll want to ⭐ this" + "Why
  omadia?") into a single scannable capability table, differentiators first
- Move the product demo GIF out of the stacked header into the "First run"
  section where it illustrates the flow

No content claims changed; all differentiator facts already verified in #369.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@iret77 iret77 merged commit cc801ab into main Jun 28, 2026
5 checks passed
@iret77 iret77 deleted the docs/readme-hero-polish branch June 28, 2026 12:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README undersells the product: core differentiators (Privacy Shield, verifier, Office compute, Conductor) are absent

1 participant