技术写作的首要诀窍

1，技术写作的好坏，跟语文水平关系不大，更多是一个技巧问题

2，技术写作的评价标准：表达是否清楚明白。它不需要华丽的词藻、巧妙的比喻、深刻的感悟，只需要把问题说清楚。

3，把问题说清楚的关键，在于思想是否清楚。当想清楚了一个问题，只要掌握几个基本诀窍，就能写出一篇很好的技术文章

4，技术写作的首要诀窍：文章采用单线结构。

"单线结构"（也称"线性结构"），指的是一篇文章只说一件事，按照线性顺序进行叙述，由浅入深、循序渐进、平铺直叙、层层递进。

5，只要采用了单线结构，技术文章就不会太差。即使内容是难懂的，至少结构是清晰的，一环扣一环，读者能知道自己卡在哪一环上。只要克服了这个难点，就能继续往前走，不会有陷入迷宫、找不到方向、如坠五里雾中。

6，有的问题比较复杂，涉及多个因素，可能是星状结构。也可能是"层次结构"。建议把这个问题拆分成多篇文章，每篇文章保持单线结构，坚持做到一篇文章只讲一点，而且争取把这一点讲透。

7，单线结构说起来容易，做起来难。难就难在，人类的思想不是单线的，而是多线的，甚至是非线性。要把混乱而跳跃的思维，整理成单线结构，表达出来，让他人理解，通常都需要反复推敲和提炼。