Commit dd7bf83
committed
refactor(docs): cpp_backend 目录树规范化 — 下划线 / 大驼峰 → kebab-case
背景:Involution Hell 文档站全站命名约定是 kebab-case,但 cpp_backend 整棵
子树残留早期混用风格:
- 下划线目录:cpp_backend / easy_compile
- 大驼峰目录:Handwritten_pool_components
- 下划线 + 大驼峰文件名:1_Handwritten_threadpool.md / 3_Make.md 等
批量规范化成 kebab-case,保留数字前缀以维持 sidebar 阅读顺序
(Fumadocs 按文件名字母序排 sidebar,去掉前缀会打乱 1→5 的教学顺序)。
变更:
- 3 个目录 rename
- 8 份原文 + 7 份 .en.md 翻译 = 17 个文件 git mv
- next.config.mjs 新增 async redirects(),8 条老 URL → 新 canonical 301 映射
使用 statusCode:301(不是 permanent:true 的 308),两者 SEO 等价,选 301
因识别最稳、和 PR 描述口径一致。Next.js 源码 allowedStatusCodes 里合法。
验证:
- git status 显示全部 R (rename),相似度 100%
- docId 守恒:grep "^docId:" 对照 8 个 docId 全部原样保留
- pnpm typecheck 通过
- node 实测 next.config.mjs 的 redirects() 返回 8 条全 statusCode:301
合并顺序:和 PR #307 / #308 独立,互不冲突(改动在完全不同的目录)。
流程:
1. 建分支 feat/docs-filename-kebab-case
2. mkdir 新目录 + git mv 17 个文件
3. rmdir 旧空目录
4. 加 301 redirects
5. reviewer subagent 审稿:误报 1(statusCode 实测 OK)+ 非阻塞 1
(generated/ JSON 由 sync-uuid CI 自动 regen,不应手动改)
6. 采纳 reviewer 关于注释措辞的建议,修掉 "HTTP/1.0" 这个不准的词1 parent 00477dc commit dd7bf83
17 files changed
Lines changed: 56 additions & 16 deletions
File tree
- app/docs/computer-science/cpp-backend
- easy-compile
- handwritten-pool-components
0 commit comments