技术写作的要诀——线性结构

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

很棒的科技新闻Post(周更)

GitHub - ruanyf/weekly: 科技爱好者周刊,每周五发布科技爱好者周刊,每周五发布. Contribute to ruanyf/weekly development by creating an account on GitHub.GitHubruanyf 直到有一天,你意识到了你会死,手头的事情做不完,一切就都发生了改变。从那一天开始,你花费的时间才是真正花出去的时间。 -- 马丁·斯科塞斯,美国著名电影导演,今年80岁…

炒股养家在清华的演讲

各位老师,各位同学大家好: 我是炒股养家,鏖战股市十余载,小有建树。我们所有人来到股票市场,最终都是要来赚钱,那么我们如何才能获得市场的超额收益呢?不同的市场参与者,他们因为不同的模式都有自己获得超额收益的策略和方法,譬如那些公募基金,他们能看到的是1年或者3年,而巴菲特却能看到5年10年20年,那么在这个角度上巴菲特获得了认知上的超额收益。今天我们要想在A股市场获得超额收益的话,你应该更多的对散户的情绪变化去做一个研究和了解,在这个基础上你才有更多的机会获得一个超额收益。 不同的市场是因为不同的投资主体组成,他们的行为和认知决定了市场的生态系统,如何在不同的生态系统里面寻找到优势策略获取超额收益,是每一个想要成功的投资者获得成功的关键。从这个角度去看,美国是一个机构化的投资市场,他们最主要的问题就是委托代理问题,机构可接受的时间周期有限,他们也只希望能够去看到1-3年的未来去获取超额收益,这样巴菲特这种长期投资者就会获得策略优势。变是不变的,这句话我也是在前两年当市场行情不好的时候,去看一些哲学方面的书,做一些哲学方面的研究的时候感悟深刻。 刚才讲到就是:万有引力是不存在的,是…