Skip to content

docs: real descriptions and distinct titles for docs pages - #64521

Merged
adamdotdevin merged 1 commit into
devfrom
seo-docs-meta
Nov 17, 2026
Merged

adamdotdevin merged 1 commit into
devfrom
seo-docs-meta

Conversation

@adamdotdevin

Copy link
Copy Markdown
Member

Issue for this PR

Closes # (none; found in an SEO audit of opencode.ai)

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

Docs frontmatter only, in 44 files under services/site/src/docs/content/.

  • Descriptions: 34 pages used the layout's fallback description, "<Title> documentation for OpenCode." Each now has a one-sentence description of what the page covers, which is what search results and AI search show for the page.
  • Titles: 18 titles are renamed so that no two docs pages share one. Before, for example, four pages were titled "Intro" and three "Effect". Examples: "CLI providers", "Effect client", "Building plugins". Sidebar labels come from lib/navigation.ts and are unchanged.

No page bodies or URLs change.

How did you verify your code works?

  • bun run generate + bun src/docs/script/build.ts (the check-docs steps) build all 664 pages.
  • In the built output, no two pages share a <title> and none uses the fallback description.

Screenshots / recordings

n/a

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@adamdotdevin
adamdotdevin enabled auto-merge (squash) November 17, 2026 21:20
@adamdotdevin
adamdotdevin merged commit 6b18e3c into dev Nov 17, 2026
12 checks passed
@adamdotdevin
adamdotdevin deleted the seo-docs-meta branch November 17, 2026 21:21

@opencodejr opencodejr Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good. This changes docs frontmatter only. I checked that title/description reach the page layout through document.tsx, that sidebar labels still come from lib/navigation.ts, and spot-checked several new descriptions against their pages; they match. Public API is unchanged. No concerns.

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