Skip to content

docs: 文档搬到 velashell-docs,Set-Version 的文档落点改成可选 - #4

Merged
joesdu merged 1 commit into
devfrom
docs/move-to-velashell-docs
Aug 29, 2026
Merged

docs: 文档搬到 velashell-docs,Set-Version 的文档落点改成可选#4
joesdu merged 1 commit into
devfrom
docs/move-to-velashell-docs

Conversation

@joesdu

@joesdu joesdu commented Aug 29, 2026

Copy link
Copy Markdown
Collaborator

docs/docs-en/ 迁到 VelaShellLabs/velashell-docszh/clien/cli,与宿主、SDK、CLI、模板的文档在同一棵树下,互相引用改走相对路径。

依赖:需与 VelaShellLabs/velashell-docs#1 一起合,否则 README 里的链接会 404。

cli.md 的版本横幅由 Set-Version.ps1 维护,见下。

scripts/Set-Version.ps1

版本横幅的落点跟着搬到了另一个仓库,而发版 runner 的 checkout 里没有它 —— 原来的 throw "落点文件不存在:…" 会让 release 流水线一上来就红。

改成:文档落点标 Repo = "docs",按 -DocsRoot\:VELASHELL_DOCS → 同级 ../velashell-docs 依次找;找不到就跳过,并在末尾 Write-Warning 列出跳过了哪几处、去哪 clone。本地开发时两个仓库通常并排放着,横幅照旧一起更新;CI 上跳过,-Check 也不会因此判失败。

两条路径都本地验过:有 docs 仓库时能正确改到 velashell-docs/zh/…en/…-Check 会把它们列进不同步表),-DocsRoot 指到不存在的路径时跳过 + 警告 + 退出码 0。

🤖 Generated with Claude Code

https://claude.ai/code/session_01JXDSZWeBqsj4Uqgn4c9jHG

docs/ 与 docs-en/ 迁到 VelaShellLabs/velashell-docs 的 zh/cli 与 en/cli,
与 SDK、模板、宿主的文档在同一棵树下,互相引用改走相对路径。

scripts/Set-Version.ps1 的 cli.md 版本横幅落点跟着搬到了另一个仓库,而
发版 runner 的 checkout 里没有它,原来的 `throw "落点文件不存在"` 会让
release 流水线一上来就红。改成:文档落点标 Repo = "docs",按
-DocsRoot / $env:VELASHELL_DOCS / 同级 ../velashell-docs 依次找,找不到就
跳过并在末尾 Write-Warning 列出跳过了哪几处。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JXDSZWeBqsj4Uqgn4c9jHG
@joesdu
joesdu merged commit 6f49cf7 into dev Aug 29, 2026
1 check passed
@joesdu
joesdu deleted the docs/move-to-velashell-docs branch September 2, 2026 03:11
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