SEO 团队反馈我们需要给 developers 项目增加一些链接,请根据文档指引来修改,#1091
Open
endless-bot wants to merge 1 commit into
Open
Conversation
Generated by Endless task #25. Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
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.
🤖 Auto-generated by Endless task #25.
Initiated by: Huacnlee Li Huashun
Background
The SEO team identified a gap in cross-domain link authority between the developer documentation site (
open.longbridge.com) and the main consumer app (longbridge.com). Users reading API/CLI/MCP/Skill documentation often do not know the corresponding features available in the Longbridge app — and the absence of links means both sites lose the SEO benefit of mutual cross-domain authority signals.The team produced a spreadsheet-style brief specifying 12 exact insertion points across three page types: the AI Skill page (
/skill/), the MCP documentation (/docs/mcp), and the CLI overview (/docs/cli/). Each entry defines the source text location, the proposed sentence with anchor text in brackets, the target URL, and step-by-step navigation instructions.All changes must respect the three-locale rule — every page exists in English (
docs/en/), Simplified Chinese (docs/zh-CN/), and Traditional Chinese (docs/zh-HK/) and must be kept in sync.Summary
docs/en,zh-CN,zh-HK/docs/mcp.md— inserted 4 links each (market data, Longbridge AI, app download, account signup)docs/en,zh-CN,zh-HK/docs/cli/index.md— inserted 1 link each ("real-time market data" → markets page)Skill.vue— 7 template sites switched tov-html; locale data strings updated for en/zh-CN/zh-HK with anchor HTML for 5 link targetsMcpTools.vue— screener note injected before thescreener_*tool cluster via<template v-for>wrapper +v-ifboundary detection; CSS addedlocales/en,zh-CN,zh-HK.json— 3 new i18n keys each for the screener noteskill-catalog/en,zh-CN,zh-HK/index.ts—longbridge-quotedescription extended with markets linkv-htmlon controlled static strings avoids restructuring the data layer. McpTools screener note uses the existinguseI18n()pattern. No schema changes needed./docs/mcp,/docs/cli/, and/skill/in all three locales; confirm each anchor text resolves to the specified target URL withtarget="_blank" rel="noreferrer".Changes
docs/en/docs/mcp.mddocs/zh-CN/docs/mcp.mddocs/zh-HK/docs/mcp.mddocs/en/docs/cli/index.mddocs/zh-CN/docs/cli/index.mddocs/zh-HK/docs/cli/index.mddocs/.vitepress/theme/components/Skill.vuev-htmlswitches + locale data string updates (en/zh-CN/zh-HK hero.desc, cases.desc, getstarted.card1.desc, capItems.news[0], demos[0].title, CAP_REFERENCE news, DEMO_SCENARIOS[0].title)docs/.vitepress/theme/components/McpTools.vuescreener_tool via<template v-for>+v-if; added.mcp-screener-noteCSSdocs/.vitepress/theme/locales/en.jsonmcp.screenerNotePrefix/NoteLinkText/NoteSuffixkeysdocs/.vitepress/theme/locales/zh-CN.jsondocs/.vitepress/theme/locales/zh-HK.jsondocs/.vitepress/theme/components/skill-catalog/en/index.tslongbridge-quotedesc: appended "View live quotes on Longbridge." linkdocs/.vitepress/theme/components/skill-catalog/zh-CN/index.tslongbridge-quotedesc: appended "查看 Longbridge 实时行情。" linkdocs/.vitepress/theme/components/skill-catalog/zh-HK/index.tslongbridge-quotedesc: appended "查看 Longbridge 即時行情。" linkKey Decisions
v-htmlfor Skill.vue string data: The locale strings are TypeScript literals, not user-supplied input, so usingv-htmlat the specific render sites that need anchor tags is safe and avoids restructuring the data model. The alternative of wrapping each string in a render function or slot would have required touching many more lines.McpTools screener note position: The
mcp-tools.jsondata is a flat alphabetical array with no group concept. Injecting a note at the boundary wherescreener_items first appear (checkingidx === 0 || !filtered[idx-1].name.startsWith('screener_')) is robust against search-filtered views — the note only shows when at least one screener tool is visible and re-appears correctly if filtering isolates the cluster.