Skip to content

docs: publish SDK 0.20.9 (latest)#4

Merged
jhfnetboy merged 2 commits into
mainfrom
docs/sync-sdk-0.20.9
Jun 18, 2026
Merged

docs: publish SDK 0.20.9 (latest)#4
jhfnetboy merged 2 commits into
mainfrom
docs/sync-sdk-0.20.9

Conversation

@jhfnetboy

Copy link
Copy Markdown
Member

目标

把 docs.aastar.io 的 latest 频道更新到 v0.20.9(npm latest / GitHub release;tag 在当前 SDK main)。

内容

  • API:在 SDK main HEAD(v0.20.9 tag)用 TypeDoc 重新生成;模块集不变(13 包)。相比上次 0.20.8 同步,main 又叠加了 #105(dual ESM/CJS build)#106(license 徽章 + docs/api 重生成),故 Defined in 链接与部分内容更新。
  • 同步链路:本次使用已合并到 SDK main 的 extract-docs.sh(自清理 + 动态包列表)+ sanitize-typedoc-md.cjs(VitePress 消毒器),无需再手工处理。
  • 版本标签:nav 下拉 + 首页徽章 0.20.8 → 0.20.9
  • 构建:pnpm run docs:build 本地通过。

⚠️ 需要 SDK 侧补一个小修(#106 漏掉)

docs/API_REFERENCE.md(手写的 API 概览,会同步成 guide/docs/API_REFERENCE.md)仍是 Version: 0.16.23 + License: MIT。本 PR 已在 docs 仓库侧改为 0.20.9 / Apache-2.0,但 SDK 源头那份没被 #106 覆盖,下次同步还会带回旧值 —— 建议在 SDK 仓库一并修 docs/API_REFERENCE.md 的版本与 license。

注:API/guide 正文为 docs:sync 机器生成,非手写。SDK package.json/CHANGELOG 顶部仍是 0.20.8(0.20.9 为 tag/release 级版本),latest 标签按你的指示设为 0.20.9。

Bumps the latest channel to v0.20.9 (npm latest / GitHub release; tag on current
SDK main, which now also carries the #105 dual ESM/CJS build and #106 license +
docs/api regeneration on top of the 0.20.8 sync).

- API: regenerated via TypeDoc at SDK main HEAD; module set unchanged (13 pkgs).
- Sync now runs the merged, self-cleaning extract-docs.sh + VitePress sanitizer.
- guide/docs/API_REFERENCE.md: Version 0.16.23 -> 0.20.9, License MIT -> Apache-2.0
  (this SDK source file was missed by upstream #106 — see note in the PR).
- Version labels: nav dropdown + homepage badge 0.20.8 -> 0.20.9.
- 'pnpm run docs:build' verified locally.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 18, 2026

Copy link
Copy Markdown

Deploying aastar-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2cfcdfd
Status: ✅  Deploy successful!
Preview URL: https://b2a8aadf.aastar-docs.pages.dev
Branch Preview URL: https://docs-sync-sdk-0-20-9.aastar-docs.pages.dev

View logs

Regenerated API docs at the exact v0.20.9 release commit so 'Defined in' source
links point at f84ad01d instead of the earlier 37c65726 baseline. guide/docs/
API_REFERENCE.md now carries the upstream-fixed Version 0.20.9 / Apache-2.0 from
SDK #107 (no longer a docs-side manual patch). Build verified.

@clestons clestons left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

clestons review — #4 [2-round, APPROVE]

docs: publish SDK 0.20.9 (latest) — 1144 文件,两轮通过。

变更确认 ✅

.vitepress/config.ts:nav 下拉版本标签 v0.20.8 (latest)v0.20.9 (latest)(2 处)✅
api/ (1142 文件):TypeDoc 重新生成,包含 SDK #105(dual ESM/CJS build)与 #106(Apache-2.0 license 更新)的内容变更;Defined in 源码链接指向 v0.20.9 ✅
同步链路extract-docs.sh(sdk#102 已合并)+ sanitize-typedoc-md.cjs,无手工处理 ✅
构建pnpm run docs:build 本地通过 ✅

关于 API_REFERENCE.md 版本问题

PR 描述提到 SDK docs/API_REFERENCE.md 旧版本/License 未更新。已由 sdk#107docs: fix API_REFERENCE.md stale version + MIT license)覆盖,下次同步将自动修正。

轮次摘要

  • Sonnet:纯 TypeDoc 重生成 + 版本标签更新,无运行时代码变更,无 findings

@jhfnetboy jhfnetboy merged commit 2166949 into main Jun 18, 2026
2 checks passed
@jhfnetboy jhfnetboy deleted the docs/sync-sdk-0.20.9 branch June 18, 2026 14:43
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