产品工作当中总是经常遇到和外部系统进行系统间对接的场景，看过很多系统交互文档，我的感受是：我们可能看到一份编写优秀的技术类说明文档，却很难看到一份长期保持优秀的文档。

写文章，一直是一种稀缺的能力。针对说明性质的技术文档，经常遇到这些问题：

写作者要把目标用户时刻放在心里，针对用户的困惑，一步一步的引导进写作者的思路当中。 写作者本身逻辑思维不仅要清晰，还要为未来的扩展做好准备。 还要持之以恒的维护 然而一份文档由一个人长期维护是很难的，接替者的思路和风格以及能力是否能和前任差不多一定是个小概率事件，接任者能否持之以恒的维护也是问题。 一个优秀的技术类文档编写者，一定是一个优秀的产品，一个跨领域者，既对要描述的内容有比较深刻的理解，也懂得用户角度会遇到什么问题，而提前做好解答。 浮躁的社会 工作变动频繁的现状 缺少榜样 草台班子 中国速度

额外唠叨：RTFM 阅读 个人素质 甲方的蛮横态度

我所说的一切都只是我的观点。
我的观点都可能是错的。

访问量统计：0