Skip to content

docs site: homepage <title> and description are not keyword-shaped (description is 615 characters) #12239

Description

@os-zhuang

One-liner

The homepage <title> is ObjectStack — Apps small enough for AI to hold whole. — a brand slogan with no term anyone searches for — and its meta description is 615 characters, roughly four times what a result shows.

Measured

apps/docs/app/[lang]/page.tsx metadata.description → 615 chars
<title>ObjectStack — Apps small enough for AI to hold whole.</title> (53 chars, 0 search terms)

Expected — bounded scope, on purpose

  • Do not touch the <h1>. The slogan stays exactly as it is; it is the maintainer's line and it works as a hero.
  • Change only metadata.title and metadata.description in apps/docs/app/[lang]/page.tsx, plus optionally the small uppercase eyebrow above the h1.
  • title: lead with what it is, keep the slogan second if it fits in ~60 characters — e.g. Open-source metadata framework for AI-built business apps.
  • description: 120–155 characters, drawn from the existing copy — the first paragraph already says it ("turns the whole app … into typed metadata"), it just needs cutting.
  • Candidate terms to place naturally, not stuff: metadata-driven framework, TypeScript, AI coding agent, MCP server, open source, self-hosted, business apps.

Acceptance

  • <title> ≤ 60 characters and names the category, not only the brand
  • meta description 120–155 characters
  • the rendered <h1> is byte-identical to what it is today

Source

Found in an SEO review of the docs site (apps/docs) run on 2026-08-25, measured against the local dev server and against production. The canonical origin is https://objectstack.ai — maintainer ruling recorded in #10659:

这个仓的文档站规范 URL 是 https://objectstack.ai

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions