Repository navigation
Shorten English guide titles and topic meta descriptions - #61
Merged
Merged
Conversation
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
marked this pull request as ready for review
October 17, 2026 05:48
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Inner pages keep the brand suffix.
EditorialPagebuilds<title>aspageHeadline(title) + " | Pi Index"(pageHeadlinestrips 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 validatepassed (unit tests,astro check, production build, rendered HTML tests).Titles
Decoded character counts (browsers and crawlers treat
&as&)./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:
/zh/packages/pi-mcp-adapter/pi-mcp-adapter:MCP 配置、惰性启动与 Token 开销 | Pi Index/zh/packages/pi-web-access/pi-web-access:安装、搜索降级、PDF 与 YouTube | Pi Index/zh/packages/tintinweb-pi-subagents/@tintinweb/pi-subagents:后台代理与 Worktree 隔离 | Pi Index/zh/topics/jev/TypeSafe AI(Jev)Pi 插件:安装、配置与选型 | Pi Index/zh/topics/pi-durable/基于 Pi Durable 的项目:应用、机器人与存储后端 | Pi IndexMeta descriptions
/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:/categories/subagents/,/categories/web-access-search/(and/zh/categories/…). These are the only categories with guide pages./topics/jev/,/topics/pi-durable/(and/zh/topics/…)./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 carrydata-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.