1. 背景
最近写了1篇博客,初心有几点
- 记录下自己生活的轨迹
- 抛砖引玉,希望大家了解LaunchBar的开发过程
- 锻炼写博客的技巧
花了几个小时写完以后,做了一下润色,就发表在简书和个人博客上,恰好刚申请的少数派Matrix作者计划也通过了,中午时候顺手记录少数派,下午少数派的HumWork 在telegram上@ 我,告诉我,我的文章润色下可以推荐上首页,于是晚上到家就联系上他,学习下如何润色文章。
2. 文章修改方案
本来我觉得写文章是个挺麻烦的一件事,文章本天成,妙手偶得之。写完思路已经定型,此时改起来,要么小修小补,润色下句子,要么可能推倒从写。想想都觉得麻烦不想继续。
努力克服自己懈怠的心理,认真和Hum 请教以后,Hum给我的文章指出几个严重的问题和具体修改建议,总结修改方案可以列为以下几点:
- 文章背景交代不清楚,为什么推荐LaunchBar,文章里提到我是从Alfred里转过来,那么首先应该介绍下LaunchBar的对比,为什么要转换过来,让看文章的读者首先要从你的个人经验中了解LaunchBar
- 说完个人心得以后,如何让人有直观了解?进一步再介绍LaunchBar的action优点在哪,可以介绍LaunchBar 几个日常高频的action,如何提高生活幸福指数的,让读者更深入的了解LaunchBar的优势
- 随后引出LaunchBar的不足问题:action数量并不丰富,没有好的渠道获取action,如何解决这个问题,官方提供了开发方案。
- 最后选取1个日常常见的使用场景,详细记录action的开发步骤
- 到这里结束了吗?并没有,最后应该把解决方案打包附在文章末尾,让读者能快速下载体会这个场景,加深对LaunchBar的兴趣
- 结束了吗?可以结束了,结束之前还可以再最后总结
3. 思考
顺着这个过程,我回忆了下看过的技术类文章,印象不深刻的或者看着就没看下去的欲望的,没有符合上面这样的过程的,有浅入深的引导我跟着作者思考整个过程 。为什么会这样呢?
我想可以归为下面2个原因:
-
作者并没有认真的给文章定位
对比开头的3点初心,发现自己只满足了第1条,后面的甚至都没当回事,文章最后变成自言自语的流水帐,自嗨用。
翻了下Reeder订阅写的好的博客,每篇文章的定位很清楚,我能跟着作者一起思考,并从中学习到知识。 -
直接描述结果,不给推导过程
读者的时间很宝贵,既然文章定位中有吸引大家了解LaunchBar和开发自己action动机,那么在读者什么都不了解的情况下直接塞给开发过程,这个事情就会让人很别扭,没有继续看下去了解的欲望了
这里不由得对比下科普达人阮一峰,阮一峰的文章写的很直白,让读者能够深入浅出明白文章中的概念和技术。
4. 总结
说到这里,如何写好技术文章的思路其实已经很清晰了,核心思想就是上面2点的肯定句。
想明白上面2点,具体的写作步骤可以归纳为:
1. 交代背景
2. 问题或者方案产生原因
3. 解决思路(+成果演示)
4. 解决步骤
5. 解决的结果
6. 总结
之后我打算按照这个步骤流水线作业写一些文章了。希望自己能写的更快更好。
5. 题外话
其实写博客这个思路可以引申到很多场景,和人沟通方面,产品的重构,事情的解决方案等。不具体扩展
网友评论