Skip to content

Commit d39f0db

Browse files
committed
docs: complete release notes navigation
Add v0.3.0 to the shared docs sidebar and order the release lists newest-first in both language indexes. The layout check now derives sidebar assertions from every release page instead of hardcoding two versions, so a release can no longer ship without its sidebar link.
1 parent 2db13e0 commit d39f0db

4 files changed

Lines changed: 20 additions & 8 deletions

File tree

docs/_layouts/docs.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,7 @@
5959
<div class="docs-nav-label">{% if is_zh %}参考{% else %}Reference{% endif %}</div>
6060
<a {% if page.url contains '/reference/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/reference/' | relative_url }}{% else %}{{ '/docs/reference/' | relative_url }}{% endif %}">{% if is_zh %}CLI 与 MCP 参考手册{% else %}CLI &amp; MCP Reference{% endif %}</a>
6161
<a {% if page.url contains '/development/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/development/' | relative_url }}{% else %}{{ '/docs/development/' | relative_url }}{% endif %}">{% if is_zh %}开发说明{% else %}Development{% endif %}</a>
62+
<a {% if page.url contains '/releases/v0.3.0/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/releases/v0.3.0/' | relative_url }}{% else %}{{ '/docs/releases/v0.3.0/' | relative_url }}{% endif %}">v0.3.0</a>
6263
<a {% if page.url contains '/releases/v0.4.0/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/releases/v0.4.0/' | relative_url }}{% else %}{{ '/docs/releases/v0.4.0/' | relative_url }}{% endif %}">v0.4.0</a>
6364
<a {% if page.url contains '/releases/v0.4.1/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/releases/v0.4.1/' | relative_url }}{% else %}{{ '/docs/releases/v0.4.1/' | relative_url }}{% endif %}">v0.4.1</a>
6465
<a {% if page.url contains '/releases/v0.4.2/' %}class="active"{% endif %} href="{% if is_zh %}{{ '/zh/docs/releases/v0.4.2/' | relative_url }}{% else %}{{ '/docs/releases/v0.4.2/' | relative_url }}{% endif %}">v0.4.2</a>

docs/manual/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ This is the English documentation home. The product site stays focused on the pr
3232

3333
- [CLI & MCP Reference](reference/) — canonical commands, operator controls, transports, and Tool families.
3434
- [Development](development/) — module boundaries, runtime invariants, release gates, and maintenance constraints.
35-
- [v0.4.1 release notes](releases/v0.4.1/) — tunnel URL extraction and Agent Context budget fixes, expanded client matrix, redesigned docs.
36-
- [v0.4.2 release notes](releases/v0.4.2/) — concurrent background tunnels with Tailscale Funnel, iMessage delivery of live links, per-tunnel retry, and graceful shutdown.
3735
- [v0.4.3 release notes](releases/v0.4.3/) — safe Agent host setup, stable tunnel-bound OAuth sessions, shared MCP transports, clearer TUI/WebUI authorization, and bounded repository structure views.
36+
- [v0.4.2 release notes](releases/v0.4.2/) — concurrent background tunnels with Tailscale Funnel, iMessage delivery of live links, per-tunnel retry, and graceful shutdown.
37+
- [v0.4.1 release notes](releases/v0.4.1/) — tunnel URL extraction and Agent Context budget fixes, expanded client matrix, redesigned docs.
3838
- [v0.4.0 release notes](releases/v0.4.0/) — faster Agent Context, architecture-first observability, resilient tunnels, and bounded development CLI automation.
3939
- [v0.3.0 release notes](releases/v0.3.0/) — historical 0.3 product shape and major changes.
4040

docs/manual/README.zh-CN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ permalink: /zh/docs/
3232

3333
- [CLI 与 MCP 参考手册](reference/) — 命令、操作入口、传输方式与工具族的统一参考。
3434
- [开发说明](development/) — 模块边界、运行时不变量、发布门禁与维护约束。
35-
- [v0.4.1 发布说明](releases/v0.4.1/) — 隧道 URL 提取与 Agent Context 预算修复、扩充的客户端矩阵、文档重设计。
36-
- [v0.4.2 发布说明](releases/v0.4.2/) — 后台并发多隧道与 Tailscale Funnel、iMessage 推送可用链接、单隧道重试与优雅退出。
3735
- [v0.4.3 发布说明](releases/v0.4.3/) — Agent 主机安全配置、与当前隧道绑定的稳定 OAuth 会话、统一 MCP 传输层、清晰的 TUI/WebUI 授权和受限仓库结构视图。
36+
- [v0.4.2 发布说明](releases/v0.4.2/) — 后台并发多隧道与 Tailscale Funnel、iMessage 推送可用链接、单隧道重试与优雅退出。
37+
- [v0.4.1 发布说明](releases/v0.4.1/) — 隧道 URL 提取与 Agent Context 预算修复、扩充的客户端矩阵、文档重设计。
3838
- [v0.4.0 发布说明](releases/v0.4.0/) — 更快的 Agent Context、Architecture-first 可观测性、Tunnel 回退与有界开发 CLI 自动化。
3939
- [v0.3.0 发布说明](releases/v0.3.0/) — 历史 0.3 系列的产品形态与关键变化。
4040

tests/documentation_layout.rs

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -287,10 +287,21 @@ fn documentation_is_unified_bilingual_and_hosted_as_html() {
287287
assert!(layout.contains("page.alternate"));
288288
assert!(layout.contains("'/zh/docs/'"));
289289
assert!(layout.contains("'/docs/reference/'"));
290-
assert!(layout.contains("'/docs/releases/v0.4.0/'"));
291-
assert!(layout.contains("'/zh/docs/releases/v0.4.0/'"));
292-
assert!(layout.contains("'/docs/releases/v0.4.3/'"));
293-
assert!(layout.contains("'/zh/docs/releases/v0.4.3/'"));
290+
for page in &pages {
291+
let Some(route) = page.permalink.strip_prefix("/docs/releases/") else {
292+
continue;
293+
};
294+
assert!(
295+
layout.contains(&format!("'/docs/releases/{route}'")),
296+
"docs sidebar must link {:?}",
297+
page.relative
298+
);
299+
assert!(
300+
layout.contains(&format!("'/zh/docs/releases/{route}'")),
301+
"docs sidebar must link the Chinese counterpart of {:?}",
302+
page.relative
303+
);
304+
}
294305

295306
let docs_css = fs::read_to_string(root.join("docs/assets/docs.css")).unwrap();
296307
assert!(docs_css.contains(".docs-shell"));

0 commit comments

Comments
 (0)