Skip to content

docs(readme): tighten top-fold — remove H1 and bold tagline#62

Merged
kmadan merged 1 commit into
mainfrom
chore/readme-top-fold
May 14, 2026
Merged

docs(readme): tighten top-fold — remove H1 and bold tagline#62
kmadan merged 1 commit into
mainfrom
chore/readme-top-fold

Conversation

@kmadan
Copy link
Copy Markdown
Contributor

@kmadan kmadan commented May 14, 2026

Summary

Follow-up to PR #61. The new hero banner SVG already contains the wordmark "AICertify" and the tagline "Compliance-as-code for AI systems" baked in. Keeping the separate <h1> and the bold tagline paragraph below it duplicated content and pushed the substantive copy down.

After this change the top sequence is:

hero banner → language switcher → one-sentence positioning line (italic) → badges → hero diagram

Applied uniformly to all 5 READMEs (en + zh-CN + ja-JP + ko-KR + hi-IN). Each language's localized positioning sentence is preserved.

Accessibility check: the banner SVG carries <title>AICertify</title> plus an alt attribute, so screen readers still get the project name. GitHub's own repo-name heading sits above the README content regardless of what's in the README.

Test plan

  • Verified rendered top-fold across all 5 language variants on the local working tree
  • Manual: review rendered READMEs in GitHub light and dark theme post-merge

The new hero banner SVG already contains the wordmark "AICertify" and
the tagline "Compliance-as-code for AI systems" baked in as part of
the brand asset. Keeping the separate H1 and bold tagline paragraph
below it duplicated content and pushed the substantive copy (and the
hero diagram) down by roughly half a screen.

After this change the top sequence is: hero banner → language switcher
→ one-sentence positioning line (italic) → badges → hero diagram.
Applied uniformly to all 5 READMEs (en, zh-CN, ja-JP, ko-KR, hi-IN);
each language's localized positioning sentence is preserved.

Accessibility: the banner SVG carries <title>AICertify</title> + an
alt attribute, so screen readers still get the project name. GitHub's
own repo-name heading sits above the README content regardless.

Reviewer recommendation in the design pass that produced the new SVGs.
@github-actions github-actions Bot added 📝 documentation Improvements or additions to documentation 🚀 enhancement New feature or request labels May 14, 2026
@kmadan kmadan merged commit 744bfcf into main May 14, 2026
6 checks passed
@kmadan kmadan deleted the chore/readme-top-fold branch May 14, 2026 09:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📝 documentation Improvements or additions to documentation 🚀 enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant