程序员最艰巨的任务跟编写代码没有多少关系。如果你认为自己还是一个水平一般的程序员,在你真正的能进入到高手行列前,请确保你已经克服了下列晋级的障碍。
如果你是测试人员,或是产品经理,你会说你不理解这些程序,你的工作中需要这些文档。我可能有些粗鲁,但如果你需要这些东西,你应该自己去写。程序员不是技术文档撰写员,写外部文档不是他们的工作,也不是他们感兴趣的。
如何使技术工程师也能写出清晰和简洁的语句?以 新闻报道的文风加上技术报告的格式。在新闻报道里,各段落都是以重要性先后排列的,所以读者可以在任何一个丧失兴趣的段落停下来,他们知道最重要的部分都已经读到,余下未读的不是那么重要了。