实践手册是站点的操作层。它把可执行指南重新聚合到一起,使读者能够从第一次构建一路走到 profiling 与加固,而不必重新学习仓库布局。
当你已经知道自己要做什么,但还不知道命令在哪一页时,就使用实践手册。它只是重新组织现有指南,而不物理移动文件,因此能在保持链接稳定的同时,为站点提供更清晰的专家叙事。
| 需求 | 从这里开始 | 结果 |
|---|---|---|
| 确认工具链与平台假设 | 先决条件 | 在构建开始前获得正确的本地环境 |
| 安装依赖并产出二进制 | 安装指南 | 获得已配置且依赖齐全的仓库 |
| 完成第一次已验证运行 | 快速开始 | 得到一次基线构建与测试通过 |
| 按顺序学习各模块 | 学习路径 | 获得跨主题的导读顺序 |
| 诊断热点路径 | 性能分析指南 | 为下一次改动建立以 profiler 为先的证据 |
| 选择优化策略 | 优化决策树 | 收敛出一组更具体的干预候选 |
| 在收尾前加固低层代码 | 验证与 Sanitizer | 完成内存、竞态与 UB 检查 |
| 复核全仓库工作习惯 | 最佳实践 | 回到与仓库姿态一致的长期规则 |
- 先各执行一次先决条件与安装指南。
- 用快速开始证明仓库可以干净地构建。
- 通过学院或学习路径选择一个主题。
- 当你开始优化时,转入性能分析指南与优化决策树。
- 在宣称完成之前,运行验证与 Sanitizer。
如果一份白皮书没有可运行路径,它就很容易沦为装饰性文本。实践手册的作用,就是防止这种情况发生。它证明架构页与研究页仍然连接着一个活的仓库,而不是只服务于一套经过修饰的叙事。