Skip to content

Shorten English guide titles and topic meta descriptions - #61

Merged
bubbleptr merged 2 commits into
mainfrom
cursor/seo-titles-descriptions-ebd5
Oct 17, 2026
Merged

bubbleptr merged 2 commits into
mainfrom
cursor/seo-titles-descriptions-ebd5

Conversation

@bubbleptr

@bubbleptr bubbleptr commented Oct 17, 2026 •

Copy link
Copy Markdown
Owner

Inner pages keep the brand suffix. EditorialPage builds <title> as pageHeadline(title) + " | Pi Index" (pageHeadline strips a trailing | Pi Index). The homepage stays brand-first (Pi Index — …). This only shortens the page-name portion of the five English guides that were 61–66 characters, and rewrites two English topic descriptions to 140–155 characters. Chinese titles were already 40–52 characters, and the Chinese descriptions were left as-is.

bun run validate passed (unit tests, astro check, production build, rendered HTML tests).

Titles

Decoded character counts (browsers and crawlers treat &amp; as &).

Page Before After
/packages/pi-mcp-adapter/ pi-mcp-adapter: MCP Setup, Lazy Servers & Token Costs | Pi Index (64) pi-mcp-adapter: Lazy MCP Servers & Token Costs | Pi Index (57)
/packages/pi-web-access/ pi-web-access: Install, Search Fallbacks, PDF & YouTube | Pi Index (66) pi-web-access: Search Fallbacks, PDF & YouTube | Pi Index (57)
/packages/tintinweb-pi-subagents/ @tintinweb/pi-subagents: Background Agents & Worktrees | Pi Index (65) @tintinweb/pi-subagents: Background Subagents | Pi Index (56)
/topics/jev/ TypeSafe AI (Jev) for Pi: Plugins, Setup & Comparison | Pi Index (64) TypeSafe AI (Jev) for Pi: Plugins & Comparison | Pi Index (57)
/topics/pi-durable/ Built on Pi Durable: Apps, Bots & Storage Backends | Pi Index (61) Built on Pi Durable: Apps, Bots, Storage Backends | Pi Index (60)

Chinese counterparts, unchanged:

Page Title Chars
/zh/packages/pi-mcp-adapter/ pi-mcp-adapter:MCP 配置、惰性启动与 Token 开销 | Pi Index 47
/zh/packages/pi-web-access/ pi-web-access:安装、搜索降级、PDF 与 YouTube | Pi Index 46
/zh/packages/tintinweb-pi-subagents/ @tintinweb/pi-subagents:后台代理与 Worktree 隔离 | Pi Index 52
/zh/topics/jev/ TypeSafe AI(Jev)Pi 插件:安装、配置与选型 | Pi Index 41
/zh/topics/pi-durable/ 基于 Pi Durable 的项目:应用、机器人与存储后端 | Pi Index 40

Meta descriptions

Page Before After
/topics/jev/ Compare five featured Jev integrations for Pi: tool-call judgments, supervision, tool discovery, skill selection and model routing. Setup, data sharing, failure behavior and reviewed source versions. (199) Compare five featured Jev integrations for Pi: tool-call judgments, supervision, tool discovery, skill selection and model routing. Setup and data scope. (153)
/topics/pi-durable/ Community projects that run on Pi Durable, Earendil's experimental durable harness: multiplayer web and iOS clients, chat bots, Home Assistant, Pi extensions, Cloudflare and PostgreSQL backends. Source-reviewed with pinned commits. (231) Community projects on Pi Durable, Earendil's experimental harness: web and iOS clients, chat bots, Home Assistant, Cloudflare and PostgreSQL backends. (150)

Chinese descriptions were not lengthened. /zh/topics/jev/ is 66 characters. /zh/topics/pi-durable/ is 134 characters, already under the English ceiling and still the full project list plus the source-review sentence, so it was left unchanged.

Homepage linking

No template change. Both / and /zh/ already expose crawlable <a href> guide links in the static HTML, separate from the category filters:

  • Category guides: /categories/subagents/, /categories/web-access-search/ (and /zh/categories/…). These are the only categories with guide pages.
  • Topic guides: /topics/jev/, /topics/pi-durable/ (and /zh/topics/…).
  • Package guides: /packages/pi-mcp-adapter/, /packages/pi-web-access/, /packages/tintinweb-pi-subagents/ (and /zh/packages/…), from the resource name and the Guide / 详情 link.

Sidebar categories, mobile options, and resource tags still point at /?category=<id> (or /zh/?category=<id>) and keep the in-page filter behavior. Guide anchors do not carry data-category, so the filter script does not intercept them.

The catalog snapshot was regenerated so published guide titles and descriptions stay in sync. That refresh also records @sfgartland/better-pi-voice, which is already in the directory but was missing from the committed snapshot.

Open in Web Open in Cursor 

cursoragent and others added 2 commits October 17, 2026 05:13
Inner pages render as the page name plus " | Pi Index". Shorten only that page-name portion on the five English guides that were 61–66 characters, and rewrite the Jev and Pi Durable meta descriptions to 140–155 characters. Refresh the public catalog snapshot to match.

Co-authored-by: Kieran <bubbleptr@users.noreply.github.com>
The rendered English title is now "@tintinweb/pi-subagents: Background Subagents | Pi Index".

Co-authored-by: Kieran <bubbleptr@users.noreply.github.com>
@bubbleptr
bubbleptr marked this pull request as ready for review October 17, 2026 05:48
@bubbleptr
bubbleptr merged commit 7c8d2e7 into main Oct 17, 2026
2 checks passed
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.

2 participants