站点图标 小满的博客 专题、文章与长期积累
ARTICLE

确定教程型专题的重写方法

确定教程型专题的重写方法

What

对技术专题树做体系化重写时,采用“总览页 + 工具页/子专题页”的结构。总览页负责解释范围、分工、学习顺序和阅读方法;每个子页按“它是什么、适用场景、核心概念、最小实践、注意事项、结论”的顺序展开。若原内容只是摘要或零散记录,需要扩写成可独立阅读的教程正文。

Why

原始专题树常见问题是只有标题、简介或资料链接,无法形成长期可维护知识。统一结构后,可同时满足顺序阅读和按需查询,也更接近阮一峰风格的技术手册写法。

Where

本次用于重构 Trilium 笔记 0c0rgYyNjpaB《DevOps 工具集合》,并可复用于后续类似的技术工具专题。

Learned

重写时不应只修文字,而要先调整目录语义,再扩写正文。根节点必须承担导航职责,子节点必须能够单独成文。