这个世界上会写字的应该要比会写代码的人多得多。但写点思路清晰的代码和写一份让人完全能读懂的文档都不是那么容易的事情。文档和代码这两件事情是相互影响的,鲜有见到文档写的好代码却写不好的事情,反过来如果一个项目文档写的很烂,那里面的代码肯定不会好到哪里去。

我现在由于所在行业的特殊性,需要和外面各种提供 API 服务的公司对接服务。这些提供 API 服务 90% 的公司文档都写得有问题,没问题的那 10% 是在行业做到顶尖的公司。

Click here to see the full blog post