Skip to content

docs(nav): drop dead case entry and repoint Supervisor to the renamed page - #23

Merged
EvovexAI merged 1 commit into
EvovexAI:mainfrom
Xx-173:docs/fix-broken-nav-entries
Sep 25, 2026
Merged

EvovexAI merged 1 commit into
EvovexAI:mainfrom
Xx-173:docs/fix-broken-nav-entries

Conversation

@Xx-173

@Xx-173 Xx-173 commented Sep 19, 2026

Copy link
Copy Markdown
Contributor

Fixes #3

What changed

Two entries under 最佳实践案例 in mkdocs.yml pointed at files that do not exist:

nav entry old path what I did
Claude Code 持续协作 user/cases/claude-code-continuous.md removed — no such file, and no reference to it anywhere in the repo
Supervisor 模式 user/cases/supervisor-mode.md repointed to user/cases/total-agent-mode.md, relabelled 总控智能体模式

On the second one: there is no supervisor-mode.md, but user/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 --strict before the change:

WARNING -  A reference to 'user/cases/claude-code-continuous.md' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A reference to 'user/cases/supervisor-mode.md' is included in the 'nav' configuration, which is not found in the documentation files.
INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
  - user\cases\total-agent-mode.md

After the change both WARNINGs are gone and total-agent-mode.md no longer appears in the
not-in-nav list.

I also walked every nav entry (72 → 71 after the removal) and every link in docs/index.md
against the filesystem: 0 remaining nav entries resolve to a missing file, and 0 of the 27
relative links in index.md are broken.

Not changed

  • mkdocs build --strict still fails overall on pre-existing anchor warnings (36 of them,
    mostly Chinese anchor links under user/guides/configuration/smart-employees.md) plus
    index.md / contribute/*.md links that intentionally point to repo-root files
    (../CONTRIBUTING.md, ../SUPPORT.md, …). Those are outside this issue's scope and I did not
    want to bundle a large link rewrite into one PR.
  • Five pages are still not in nav: 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 I
    can'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 --strict before-and-after
were verified directly against a local checkout.

… 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
@Xx-173

Xx-173 commented Sep 22, 2026

Copy link
Copy Markdown
Contributor Author

Docs/config-only change: mkdocs.yml drops a dead case entry and repoints the
Supervisor nav item to the page it was renamed to (+1/-2, single file).

Mergeable with no conflicts. Same ask as #22 — a look whenever it suits you.

@EvovexAI EvovexAI left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

修复精准. 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.

@EvovexAI
EvovexAI merged commit 25c568e into EvovexAI:main Sep 25, 2026
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.

[docs] Fix broken Quick Links / nav entries in docs

2 participants