阮一峰老师文章《技术写作的首要诀窍》,作者分享写作结构技巧
阮一峰老师写过一篇文章:《技术写作的首要诀窍》https://t.co/jsyZ1WRxUO
我自己写技术文章常用的有两个简单的结构:
1. 是什么?为什么?怎么办?
2. 提出问题;分析问题;解决问题。
写技术文章的时候,写完看看有没有漏,比如常犯的错误就是通篇在讲是什么和为什么,没有怎么办,读者没有收获;或者直接上来贴代码,只有解决方案,没有让读者知道要解决的问题或者分析过程
不过所有的技巧都抵不过多写!
我自己写技术文章常用的有两个简单的结构:
1. 是什么?为什么?怎么办?
2. 提出问题;分析问题;解决问题。
写技术文章的时候,写完看看有没有漏,比如常犯的错误就是通篇在讲是什么和为什么,没有怎么办,读者没有收获;或者直接上来贴代码,只有解决方案,没有让读者知道要解决的问题或者分析过程
不过所有的技巧都抵不过多写!
有点长,我分享一下我的写作技巧:
1. 金字塔结构:写作的之前先想好要表达哪几点,最好的方法是3个点,不要整多了,读者看不完
2. 总分总:先把结论写前面,这样读者有一个 “总 -> 分 -> 总” x.com/dotey/status/1…