Skip to content

fix: 修复场景入口索引冲突并记录 API 上线验收 - #73

Merged
yi-ge merged 1 commit into
mainfrom
codex/api-publication-verification
Oct 15, 2026
Merged

yi-ge merged 1 commit into
mainfrom
codex/api-publication-verification

Conversation

@yi-ge

@yi-ge yi-ge commented Oct 15, 2026

Copy link
Copy Markdown
Member

变更说明 / Description

API 文档 #72 已自动部署,16个页面与8个下载的正式线上验收全部通过。全站验收718个URL均200,但应用场景中英文入口的canonical被目录README隐式索引覆盖为尾斜杠地址。

  • 将作者资产说明 docs/03-use-cases/README.md 重命名为 _README.md,由已有Docusaurus默认规则排除;正文逐字保留,无仓内引用需要调整。
  • 保留正式 /use-cases 和 /en/use-cases 的slug、正文与导航。重建后两入口canonical和标题均准确。
  • 回写API正式Production deployment及逐项生产验收报告;全站门禁保持严格,部署后再次验收。

The API documentation is already deployed and all 16 API pages / 8 downloads passed production acceptance. The site-wide audit exposed an existing README/index output collision at the bilingual use-case landing pages. Rename the author-only README to use Docusaurus's existing exclusion convention; preserve the real landing pages and all API contracts. Record production evidence without treating the two existing SEO failures as passed.

验证 / Validation

  • Bilingual production build passed.
  • Built /use-cases and /en/use-cases now have exact canonicals and their intended headings, “应用场景” / “Use Cases”.
  • pnpm api:check -- --build: 8 bilingual groups / 24 operations / 3 specs and identical downloads passed.
  • Existing README has no repository references; no language fallback page should be generated for an author-only asset guide.
  • API production evidence from deployment 7088235715 is saved in api/production-verification.json; source remains merged API code e45f229.
  • After this PR deploys, rerun site-wide production HTTP/SEO verification.

@vercel

vercel Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 15, 2026 9:04am UTC

Request Review

@yi-ge
yi-ge merged commit 5d9cef1 into main Oct 15, 2026
6 checks passed
@yi-ge
yi-ge deleted the codex/api-publication-verification branch October 15, 2026 09:05

This branch was successfully deployed

1 active deployment
Preview — 7803ffc4 Deployed Oct 15, 2026 by vercel[bot]
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