docs(nav): drop dead case entry and repoint Supervisor to the renamed page - #23
Merged
Merged
Conversation
… page Two entries under 最佳实践案例 pointed at files that do not exist: - user/cases/claude-code-continuous.md - no such file, and no reference to it anywhere in the repo. Dropped. - user/cases/supervisor-mode.md - no such file. The case was renamed to user/cases/total-agent-mode.md (案例七:总控智能体模式——多角色自动编排), which was the only case page missing from nav. Repointed and relabelled to match the page title. mkdocs build --strict reported both as WARNING before this change and reports neither after it. Fixes EvovexAI#3
Contributor
Author
|
Docs/config-only change: Mergeable with no conflicts. Same ask as #22 — a look whenever it suits you. |
EvovexAI
approved these changes
Sep 25, 2026
EvovexAI
left a comment
Owner
There was a problem hiding this comment.
修复精准. mkdocs build --strict before/after 实测证据完整: 消除 2 个 WARNING + 1 个 not-in-nav. claude-code-continuous.md 删除正确 (无引用), supervisor-mode.md 重指向 total-agent-mode.md 且 relabel 与页面标题一致. 作者明确 '若 supervisor 是独立页面, 我可以恢复', 给后续留余地. LGTM.
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.
Fixes #3
What changed
Two entries under 最佳实践案例 in
mkdocs.ymlpointed at files that do not exist:user/cases/claude-code-continuous.mduser/cases/supervisor-mode.mduser/cases/total-agent-mode.md, relabelled 总控智能体模式On the second one: there is no
supervisor-mode.md, butuser/cases/total-agent-mode.md(案例七:总控智能体模式——多角色自动编排) was the only case page missing from nav, and its
content is exactly the supervisor story — "自动拆解任务、分配不同 AI 角色去干、监督进度、出错
自动调整方案……它就像是你的技术总监". So the entry looks like a rename that nav never followed.
I relabelled it to match the actual page title rather than leaving the stale English label.
If you actually intended a separate Supervisor page that still needs to be written, say so and
I'll restore the entry instead.
How this was checked
mkdocs build --strictbefore the change:After the change both WARNINGs are gone and
total-agent-mode.mdno longer appears in thenot-in-nav list.
I also walked every nav entry (72 → 71 after the removal) and every link in
docs/index.mdagainst the filesystem: 0 remaining nav entries resolve to a missing file, and 0 of the 27
relative links in
index.mdare broken.Not changed
mkdocs build --strictstill fails overall on pre-existing anchor warnings (36 of them,mostly Chinese anchor links under
user/guides/configuration/smart-employees.md) plusindex.md/contribute/*.mdlinks that intentionally point to repo-root files(
../CONTRIBUTING.md,../SUPPORT.md, …). Those are outside this issue's scope and I did notwant to bundle a large link rewrite into one PR.
user/explanation/asset-center.md,user/guides/configuration/asset-center.md,.../resource-packs.md,.../install-own-project-as-extension.md,assets/sponsors/README.md. Left alone since Ican't tell whether they're intentionally unlisted — happy to add them in a follow-up.
AI involvement
Drafted with AI assistance. The nav/link audit and the
mkdocs build --strictbefore-and-afterwere verified directly against a local checkout.