标签: 技术文档

清除筛选

Diátaxis 文档框架:教程、指南、参考与解释

技术文档经常出现一种结构性故障:教程里塞满概念解释,API 参考页写成操作指南,部署手册又夹杂产品背景。每一段内容单独看都可能正确,读者却很难在需要的时候找到能直接使用的信息。 Diátaxis 是一套专门处理这类问题的技术文档框架。它把文档分为教程(Tutorials)、操作指南(How-to guides)、参考(Reference)和解释(Explan…