先说结论:它不是把文章分四类,而是先问读者此刻要完成什么

Diátaxis 的四种模式很容易被做成一张图,却常被误用成栏目标签。Tutorial 要带着学习者安全完成一次可理解的练习;how-to guide 面向已有基础、正在解决具体问题的人;reference 提供准确、完整、可查的事实;explanation 则回答为什么、背景是什么、这些概念如何关联。两条判断轴是:内容服务行动还是认知,读者正在学习还是工作。作者先确定意图,才知道一页里什么该保留、什么应移到别处并链接回来。

对中文创作者,这套方法最实用的场景是课程、工具说明、产品帮助中心和长期知识库。很多“终极教程”同时塞入入门练习、故障排除、参数大全、行业历史和作者观点,结果新手走不完、熟手找不到答案、维护者也不知道版本变化该改哪里。把它们拆开后,教程可以对成功体验负责,操作指南直接解决任务,参考表跟随产品结构更新,解释文章则保留比较、争议与背景。

四格法能暴露问题,但不会自动修好内容

官方质量页面明确区分功能质量与深层质量:准确、完整、一致、精确和有用需要作者持续核验;流畅、贴合人的需要和好用则需要判断与设计。Diátaxis 能让混杂和缺口变得明显,却不能替你验证事实、维护版本、研究中文读者、处理搜索意图、做无障碍或保证页面好看。Canonical 的采用案例也强调,这只是更大文档实践的一部分,而不是一次分类迁移就结束。

最好的中文实测不是把已有目录机械改名,而是选一个真实任务做前后对照。让新手按教程完成第一次操作,让熟手只靠 how-to 排除故障,让开发者在 reference 中查参数,再让读者用 explanation 理解取舍;记录他们卡在哪里、用了多久、是否需要来回跳页。若加入 AI,模型可以先判断页面意图和找出混写段落,但事实、中文术语、例外、版本与链接仍由人负责。引用官网定义或翻译图表时也要控制篇幅并核对授权,因为“可访问的方法”不等于“整站内容可自由复制”。