Skip to content

chore(docs): 清理重复导航、失效导航项与误提交的 __pycache__ - #1385

Closed
xingwunian wants to merge 3 commits into
masterfrom
chore/docs-nav-dedupe
Closed

xingwunian wants to merge 3 commits into
masterfrom
chore/docs-nav-dedupe

Conversation

@xingwunian

@xingwunian xingwunian commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

这个 PR 只做清理,不动任何模块代码

按「导航重复 / 指向不存在的文档 / 误提交的缓存文件」三件事清一遍:

1. mkdocs.yml(删 3 行)

  • ROS2 差速机器人 A* 全局规划与 DWA 局部避障 出现在 199 与 250 两处(文字完全相同),删后者;
  • 基于串级PID的四旋翼航点定点悬停与抗风扰仿真 在 443/444 连续两行完全重复,删其一;
  • ROS2 DWA 局部规划器随机场景压力测试与舒适性评价 指向 docs/ground/ros2_dwa_benchmark.md,该文件在仓库里不存在,删该导航项。

2. docs/index.md(删 2 行)

  • 同一篇 DWA 文档在 263 与 310 各列一次,删 263(保留带描述的那条);
  • 264 指向同一篇不存在的 ros2_dwa_benchmark.md,一并删除。

3. 误提交的缓存文件

  • src/humanoid/g1_rgb_floor_patrol 下 9 个 __pycache__/*.pyc(来自 feat(humanoid): G1 RGB 地面分割巡检 #1272 的合并提交 4aa8f613;根 .gitignore 里本来就有 __pycache__,这些是被 git add -f 硬塞进来的);
  • src/ground/carla_lidar_obstacle_detection/.pytest_cache 下 6 个文件。

验证:删掉的每一条都先确认「文本确实重复」或「目标文件确实不在 git tree -r master 里」;改动后 mkdocs.yml 导航 418 → 415 条,docs/index.md 443 → 441 条链接,无新增死链。

Deploy 目前仍是 success(mkdocs 不是 strict 模式),所以这些是「脏」而不是「红」;但重复导航会让同一页面出现两次、失效项会让站内搜索和侧栏一直有个坏链接。

后续我审核时会把这几条作为硬门槛(导航条目唯一、目标文件必须存在、不许提交 __pycache__ / .pytest_cache / 结果与中间文件、不许夹带与选题无关的改动)。

- mkdocs.yml:`ROS2 差速机器人 A* 全局规划与 DWA 局部避障` 出现两次(199/250),删后者;
  `基于串级PID的四旋翼航点定点悬停与抗风扰仿真` 连续两行完全重复(443/444),删其一;
  `ROS2 DWA 局部规划器随机场景压力测试与舒适性评价` 指向 `docs/ground/ros2_dwa_benchmark.md`,该文件不存在,删该导航项。
- docs/index.md:同一篇 DWA 文档在 263 与 310 各列一次,删 263(保留带描述的 310);264 指向同一篇不存在的文档,一并删除。
- 删除 `src/humanoid/g1_rgb_floor_patrol` 下误提交的 8 个 `__pycache__/*.pyc`。

只改导航与垃圾文件,不动任何模块代码;删除的每一条都先核对了「确实是重复」或「目标文件确实不存在」。
@xingwunian xingwunian closed this Nov 12, 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.

1 participant