1,技术写作的好坏,跟语文水平关系不大,更多是一个技巧问题
2,技术写作的评价标准:表达是否清楚明白。它不需要华丽的词藻、巧妙的比喻、深刻的感悟,只需要把问题说清楚。
3,把问题说清楚的关键,在于思想是否清楚。当想清楚了一个问题,只要掌握几个基本诀窍,就能写出一篇很好的技术文章
4,技术写作的首要诀窍:文章采用单线结构。
"单线结构"(也称"线性结构"),指的是一篇文章只说一件事,按照线性顺序进行叙述,由浅入深、循序渐进、平铺直叙、层层递进。
5,只要采用了单线结构,技术文章就不会太差。即使内容是难懂的,至少结构是清晰的,一环扣一环,读者能知道自己卡在哪一环上。只要克服了这个难点,就能继续往前走,不会有陷入迷宫、找不到方向、如坠五里雾中。
6,有的问题比较复杂,涉及多个因素,可能是星状结构。也可能是"层次结构"。建议把这个问题拆分成多篇文章,每篇文章保持单线结构,坚持做到一篇文章只讲一点,而且争取把这一点讲透。
7,单线结构说起来容易,做起来难。难就难在,人类的思想不是单线的,而是多线的,甚至是非线性。要把混乱而跳跃的思维,整理成单线结构,表达出来,让他人理解,通常都需要反复推敲和提炼。
8,老外的一篇文章
网友评论