完全不同的工具集
2006 年的技术写作者更常使用桌面出版、办公格式和手工维护的帮助系统。Git 协作、continuous delivery 与 AI 辅助初稿并不是默认条件。
工具变化很快,职业核心没有同样快地改变。
受众仍是第一项设计决策
管理员、API 开发者和终端用户需要不同的信息组织。理解读者要完成什么任务仍是有用文档的基础。
结构比格式更长寿
清晰层级、可预测导航、一致术语和任务导向组织能够跨越格式迁移。
核验仍然区分文档与文案
技术写作者始终需要接触真实产品行为。今天可以自动化更多检查,但对事实负责这一点没有消失。
真正改变的部分
文档更深入参与 software delivery:仓库、API、CI、analytics 与结构化内容都成为常见工作对象。读者期待搜索、deep link、可运行示例和快速更新。
值得保留的东西
从 2006 年保留职业纪律:了解受众、核验事实、管理术语、设计结构并对发布内容负责。工具和格式则应该继续变化。
实践示例
阅读《2006 年的技术写作者还留下了什么?》时分成两栏:哪些属于当时的技术条件,哪些属于长期存在的文档问题。用今天的工具重做一个小型历史流程,例如发布说明、术语表或离线手册,并标记哪些决策虽然媒介改变了却仍然相同。
寻找长期模式:
- 读者怎样找到信息;
- 更正怎样分发;
- 发布后谁负责准确性;
- 旧媒介的哪些限制反而带来了有用的纪律。
历史材料的价值,在于帮助我们更清楚地看见今天的问题。目标不是恢复旧工具,而是把持久的编辑原则与特定时代的媒介分开。
快速编辑检查
- 完全不同的工具集. 2006 年的技术写作者更常使用桌面出版、办公格式和手工维护的帮助系统。
- 受众仍是第一项设计决策. 管理员、API 开发者和终端用户需要不同的信息组织。
- 结构比格式更长寿. 清晰层级、可预测导航、一致术语和任务导向组织能够跨越格式迁移。
- 核验仍然区分文档与文案. 技术写作者始终需要接触真实产品行为。今天可以自动化更多检查,但对事实负责这一点没有消失。



