Skip to content

docs(website): improve homepage SEO metadata and messaging#3199

Merged
dalibran merged 11 commits into
mainfrom
seo/improve-homepage-metadata
Apr 27, 2026
Merged

docs(website): improve homepage SEO metadata and messaging#3199
dalibran merged 11 commits into
mainfrom
seo/improve-homepage-metadata

Conversation

@dalibran

Copy link
Copy Markdown
Collaborator

Summary

  • Updates site title, tagline, and homepage <Layout> meta tags to improve search discoverability
  • Rewrites hero headline and standfirst to lead with the user benefit (trustless light client access) rather than a generic description
  • Updates the announcement bar to reflect that the Mithril Signer Node is now stable and production-ready
  • Changes the hero CTA from "Learn more" → "Run a Signer Node" with a direct link to the signer guide

Test plan

  • Verify <title> and <meta name="description"> render correctly in page source
  • Check announcement bar displays correctly and link works
  • Confirm hero CTA links to the signer node guide

🤖 Generated with Claude Code

@dalibran

Copy link
Copy Markdown
Collaborator Author

one missing part of this would be a ceremonial major version bump to the signer node, so that SPOs are extra confident that this part of Mithril isn't in beta anymore

@github-actions

github-actions Bot commented Apr 14, 2026

Copy link
Copy Markdown

Test Results

     5 files  ±0     199 suites  ±0   59m 34s ⏱️ + 1m 20s
 2 905 tests ±0   2 905 ✅ ±0  0 💤 ±0  0 ❌ ±0 
10 268 runs  ±0  10 268 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit 2452909. ± Comparison against base commit 44502bd.

♻️ This comment has been updated with latest results.

Comment thread docs/website/homepage-content/hero.ts Outdated
Comment thread docs/website/homepage-content/hero.ts Outdated
Comment thread docs/website/src/components/HomepageHero.tsx Outdated
Comment thread docs/website/src/pages/index.tsx
Comment thread docs/website/src/pages/index.tsx Outdated
Comment thread docs/website/docusaurus.config.js Outdated
Comment thread docs/website/docusaurus.config.js Outdated
Comment thread docs/website/homepage-content/hero.ts Outdated
@dalibran
dalibran temporarily deployed to testing-preview April 15, 2026 15:46 — with GitHub Actions Inactive
@dalibran
dalibran temporarily deployed to testing-preview April 16, 2026 06:25 — with GitHub Actions Inactive
Comment thread docs/website/homepage-content/hero.ts Outdated
Comment thread docs/website/src/components/HomepageHero.tsx
Comment thread docs/website/homepage-content/hero.ts Outdated
@dalibran dalibran linked an issue Apr 17, 2026 that may be closed by this pull request
Comment thread docs/website/docusaurus.config.js Outdated
Comment thread docs/website/src/components/HomepageHero.tsx
@dalibran
dalibran temporarily deployed to testing-preview April 21, 2026 16:20 — with GitHub Actions Inactive
Comment thread docs/website/docusaurus.config.js
@dalibran
dalibran temporarily deployed to testing-preview April 23, 2026 15:30 — with GitHub Actions Inactive

@jpraynaud jpraynaud left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

dalibran and others added 11 commits April 27, 2026 09:03
- Update site title and tagline to be more descriptive and keyword-rich
- Add explicit title/description to homepage Layout for better meta tags
- Update hero headline and standfirst to clarify Mithril's value prop
- Change CTA button to "Run a Signer Node" pointing to the signer guide
- Update announcement bar copy to reflect signer node production readiness

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
adds missing article to improve copy

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>
Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>
Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>
Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>
Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>
- Update site title to "Mithril | Trustless state proofs for Cardano"
- Rewrite hero standfirst to lead with the tech and include use-case examples
- Make hero section full-viewport-height on tablet with centered layout
- Reduce hero heading font size slightly (4rem → 3.5rem) for better fit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Remove trailing period from hero title
- Remove unused spoCta field
- Revert viewport-height positioning changes, keep font and button size updates

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@dalibran
dalibran force-pushed the seo/improve-homepage-metadata branch from 546c0b0 to 2452909 Compare April 27, 2026 16:06
@dalibran
dalibran temporarily deployed to testing-preview April 27, 2026 16:41 — with GitHub Actions Inactive
@dalibran
dalibran merged commit 8e4b4bf into main Apr 27, 2026
98 of 99 checks passed
@dalibran
dalibran deleted the seo/improve-homepage-metadata branch April 27, 2026 16: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.

Improving Mithril Documentation

3 participants