about
Calvin’s Marbles的写作方式
一篇文章的价值,如果其独创性、覆盖面以及深度等“干货”占了一半,那另一半就是语言逻辑、简洁性、文采等看似“虚无缥缈”的东西。但写博客并不是写书,做到尽善尽美的代价太高了,因此写博客要有所选择。写博客的时候,我选择将重点依次放在准确、详尽、逻辑清晰上。
准确
一篇文章的准确性是最重要的,准确性不仅仅要求内容真实,更需要描述力求精确,这是很不容易做到的。
详尽
CSDN 和 StackOverflow 都是大型的程序员论坛,里面大神云集,然而遇到技术问题时,我的经验是 StackOverflow 这个英文网站相比 CSDN 更容易解决我的问题。这是不仅是因为 CSDN 上随处可见的抄袭(其中不甚枚举的博主都直接搬运了我的文章)降低了搜寻答案的效率,也因为写这些博客的大神水平较高,有很多“显然的”细节便不去交待,这不可避免给读者造成很大的困扰;而 StackOverflow 通过其严格的社区规范保证了问题与解答都足够精确、“接地气”,问题的解决方案在回答里能够逻辑清楚、一目了然地列出。
有的人觉得遇到不懂的问题,就应该继续 Google,直到搞懂为止,而不是像小白一样,不懂就问。我是持反对观点的。即便是小白问题,只要有自己思考就完全有资格去问,人都是从不会到会的,如果因为一个问题简单就拒绝回答是不利于社区的发展的。而且遇到这些问题的人也不一定就是小白,查阅文档或源码后虽然解决问题,却很耗时。所以既然自己花了时间,分享出来帮帮别人又何乐不为呢?何况在写作过程中,不可避免地要对原理进行进一步的总结、剖析,对自己的进步也是有帮助的。
因此在我的博客中,会去写一些看起来很“弱智”的问题,或者自己一些钻牛角尖式的思考过程,而不是试图写一篇通用的说明——这种网上的好教程太多了。对于99%的人,他们不会产生和我类似的想法,也看不到我的文章,但如果有哪怕1%的人不巧遇到了和我类似的问题,他们就能够搜索到我的文章,并从中得到一些启示,而不是对着一堆内容大同小异的精致文章而望洋兴叹,和我一样浪费很多时间在纠结。
逻辑清晰
写一篇逻辑清晰的文章能够节省读者非常多的时间,更好地解决读者可能遇到的问题,但这对于作者来说是要求颇高的。譬如,作者不能指望读者和自己有着类似的“脑回路”,很多自己看来一目了然的逻辑在别人眼里是完全无法理解“天书”。因此他必须花时间去细细揣摩自己的逻辑,避免它们太过跳跃。
我认为文章的详尽要求是高于逻辑清晰要求的,一篇“啰嗦”的文章,读者完全可以跳跃的阅读,甚至可以放弃阅读全文,而通过搜索关键词的方式进行查阅。因此我在很多时候为了加入一些“钻牛角尖”会破坏文章的逻辑性,这是我在有限的精力上做出的妥协,也是我写作能力可提高的地方。