技术写作的要诀——线性结构
技术写作非常重要,产品的开发、推广、维护都需要它。 跟大家想的不一样,技术写作的好坏,跟语文水平关系不大,更多是一个技巧问题。 因为技术写作的评价标准,不是艺术性,而是表达是否清楚明白。它不需要华丽的词藻、巧妙的比喻、深刻的感悟,只需要把问题说清楚。 把问题说清楚的关键,在于你的思想是否清楚。 当你想清楚了一个问题,只要掌握几个基本诀窍,就能写出一篇很好的技术文章。 今天,我来说说,技术写作的首要诀窍是什么。很简单,就是一句话:文章采用单线结构。 所谓“单线结构”(也称“线性结构”),指的是一篇文章只说一件事,按照线性顺序进行叙述,由浅入深、循序渐进、平铺直叙、层层递进。 这就好比一个游览区,只有一条游览路线,从入口到出口,跟着箭头一路走,就能看到所有景观,非常明白清楚。 如果同时有好几条路线,游客就会糊涂,到底选哪一条?会不会错过景观?要是这些路线还互相交叉,那就更糟糕了,游客非串线不可。 (图片说明:…