Skip to content

fix(seo): expand homepage content to resolve Google soft 404#374

Draft
decofe wants to merge 1 commit intomainfrom
fix/homepage-seo-content
Draft

fix(seo): expand homepage content to resolve Google soft 404#374
decofe wants to merge 1 commit intomainfrom
fix/homepage-seo-content

Conversation

@decofe
Copy link
Copy Markdown
Member

@decofe decofe commented May 4, 2026

Problem

Google Search Console classifies the docs homepage (docs.tempo.xyz) as a soft 404, preventing it from being indexed. This is caused by thin content — the current homepage has ~1,200 characters of prose (3 short paragraphs + 6 card titles), which Google's quality classifier treats as a navigation shell rather than a substantive page.

75 additional pages are also flagged as 'crawled but not indexed', likely influenced by the homepage's low quality signal.

Fix

Expand the homepage from ~1,200 to ~4,600 characters of meaningful prose while preserving the existing card grid:

  • Rewrite intro with concrete protocol details (~500ms finality, stablecoin-denominated fees, Osaka EVM target, open source Apache license)
  • Add 'Tempo-specific features' section covering TIP-20 native stablecoins, accounts/transactions, agentic payments (MPP), and Zones — with deep links into the relevant docs pages
  • Add 'What these docs cover' section as a navigational guide for different user types (evaluators → integration guide, builders → payments/accounts, operators → protocol spec/node docs)

Verification

  • All 27 internal links verified against existing pages
  • Content follows Tempo docs voice: direct, technical, concrete claims anchored to specifics
  • No marketing filler or hype language
  • Every claim is consistent with existing docs content (TIP-20 spec, performance page, transaction docs)

After merge

  1. Request re-indexing of https://docs.tempo.xyz/ in Google Search Console → URL Inspection → Request Indexing
  2. Resubmit the sitemap
  3. Monitor GSC over the next 2-4 weeks for the soft 404 to clear

Google Search Console classifies the docs homepage as a 'soft 404'
because the page has too little prose content (~1200 chars) relative
to navigation elements, causing the quality classifier to treat it
as a thin/empty page.

This expands the homepage from ~1200 to ~4600 chars of meaningful
prose while preserving the existing card grid:

- Rewrite intro with concrete protocol details (~500ms finality,
  stablecoin fees, Osaka EVM target, open source)
- Add 'Tempo-specific features' section covering TIP-20, accounts,
  agentic payments, and Zones with deep links to docs
- Add 'What these docs cover' section as a navigational guide
  for different user types (evaluators, builders, operators)
- All internal links verified against existing pages
- Voice follows Tempo docs conventions: direct, technical,
  concrete claims anchored to specifics, no marketing filler
@vercel
Copy link
Copy Markdown

vercel Bot commented May 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment May 4, 2026 10:56am

Request Review

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.

1 participant