在程序员这个行业,坚持做技术写作的人一直比较少. 我和身边的朋友沟通后,发现他们除了借口没有时间外,大多没有意识到写作带来的收益.

抄录一下近期一篇好文章…

文案的力量

来自: 2014-10-26 小道消息 by Fenng

文案对于互联网产品的作用,就好比路标对行路人的作用. 清晰无误的文案带来的效果有的时候胜过胜过数百行代码. 和百姓网的朋友交流的时候谈到他们的一个真实案例:付费产品的转化率始终始终无法提高,后来产品人员在表单下面添加了一小行文字,意想不到的是,转化率增加 20% 多;最近丁香园的某个产品改进过程中也有一个相似的例子,功能本身没有改变,只是增加了一行文字提示,结果? 询价量大幅上升.

我无意夸大这两个案例有多么神奇,而想强调的是,我们可以通过一些成本最低的改进来改善我们的产品,那就是, 写更好的文案.

差的文案有什么影响? 举个例子吧,糟糕的路标有的时候让人恼火,比如北京地铁最早用东西南北做出口的标记,你可以想一下有多少人在地铁里能分清方向? 这是一个经典反面案例; 而支付宝当年因为证书问题导致用户修改信息陷入’死循环’,其实也是加一行文字就能避免用户多次重试; …

国内的互联网创业公司似乎并不怎么重视产品文案的力量 (当然当下多数人也不重视文字的力量). 有些团队喜欢在技术和数据分析上猛下功夫,但是不知道,用户有的时候在一堆功能前一头雾水的主要原因就是你的文案写的不够清晰. 好的文案样本可以看一下豆瓣的,清晰直接,一目了然. 每次豆瓣发布新产品或是改版,我都要仔细学习一下豆瓣产品经理的文章, 比如这篇 豆瓣的初衷 , 在国内互联网产品团队中堪称无出其右.

国外的互联网创业公司相对来说,更重视写作能力,看重文字,比如 37 Signals 一以贯之的实践,甚至在"重来"这本书中写到 '会写就代表会思考', 并且建议’如果你准备从一堆人挑出一个人做某份工作,那就挑文章写的最好的那个’,我个人很赞同这个观点.

…

注意:以上所说的’文案’,单指互联网产品的’文案’,不是指广告公司面对的那种’文案’.

作为码农,我们为什么要写作

另外一篇好文章, 来自: Jan 8th, 2014 作为码农,我们为什么要写作 - 唐巧的技术博客

更进一步的阐述了原因:

提高自己对知识的掌握层次

美国教育心理学家Bloom将知识认知分为了两个维度,其中认知历程维度又分为6个层次,分别为:记忆,理解,应用,分析,评鉴,创造. 如下图所示,层次越高,表示对知识的掌握程度越深.

对于写作者来说,在写作过程中,因为需要对知识进行精确地表述,常常要对知识的细节再次的探索. 在这个过程中,写作者可能会发现自己的观点不清晰的地方,通过二次学习,使自己的理解更加完善. 写作者也可能会发现自己观点中的错误,从而改正自己的曲解. 在经历过这段过程后,通常对于自己所写的知识的掌握程度,都上升了一个层次.

我自己的每次技术写作都经历了这样的提高过程. 所以,我更多时候是把写作当成学习的一种方式. 这种学习方式比普通的学习方式更加深入,效果更好. 当然,花费的时间也更多.

提高表达和沟通的能力

作为一个程序员,日常的工作大部分时间都是面对电脑. 许多人周末也喜欢当一个技术宅,待在家里上网,看电影或者玩游戏来消遣. 长时间的面对机器,使得我们的语言表达能力极度衰退. 而写作是一个很好的机会,让我们练习自己的表达能力.

长时间写作之后,你会更加注意平时沟通的语言. 你的用词更加精准,表达更加生动. 在表达能力提高的同时,你的沟通效率也得到提高.

接受读者的沟通和反馈

当你的文章通过博客或者InfoQ网站发表出来后,你就会接着获得写作的第三个好处:来自读者的沟通和反馈. 一篇好的文章通常会吸引一些读者回复,通过和读者的交流,你可以收获以下好处:

1. 错误内容反馈:尽管文章在写作时经历过二次学习,但是人难免会犯错. 写作将你的思想完全暴露出来,有水平的读者可以指出你文章中的错误,从而使你对知识的理解更加准确. 我的很多博客文章都有一些细微错误,通过读者的找反馈,我很快就将错误内容改正过来了,自己的水平也得到了提高.
2. 认识朋友:一个乐于分享的人总会比沉默寡言的人更招人喜欢. 所以通过写作,你可以结交很多和你一样,乐于分享的朋友.
3. 了解更多相关信息:一些读者会回复说:”某某框架也用了这个技术方案”,或者是:”你的这个实现方案没有另一个某某开源方案好”. 这些信息,作为你当前文章知识点的补充,使你能够了解更多相关的资料,再一次完善自己所学的知识.

影响力

当你持续的写作,坚持一年以上,你就会慢慢收获影响力. 这个时候,你也会收到技术大会的分享邀请,出版社的约稿邀请,著名互联网公司的工作邀请,甚至是创业项目的合伙人邀请. 你相比那些不分享的人,获得了更多的机会. 当然你的技术观点也会被更多人接受,你也会收获到传递知识的乐趣.

结束语

• 在写作过程中,你将收获提高自己对知识的掌握层次和提高表达和沟通的能力的好处.
• 在写作结束后,你将收获错误内容反馈,认识朋友和了解更多相关信息的好处.
• 在坚持写作一段时间,你将收获影响力和传递知识的乐趣.

另外,”暗时间”的作者刘未鹏在他的文章,也总结了很多写作的好处,大家也可以看看. 看了写作的这么多好处,你是否心动?那赶快创建一个博客,开始你的技术写作之旅吧!

是也乎

大妈 之前常用的一个比喻就是 反刍 , 偶蹄类生物为了更好的消化粗糙的食物,不得不有空就进行 反刍;

而面对互联网时代信息大爆炸,如何有效提高自个儿的信息处理能力?!

• 只能在战斗中学习战斗!
• 必须在持续的信息处理过程中整理出最适合自个儿的 过程/方式/工具
• 那怎么证明自个儿当前的信息处理是有效的?
• 自然是将以为自个儿明白的事儿写将出来
  • 如果别人看的懂,学的会,说明自个儿是真明白了
  • 而且,其实,在撰写这一输出过程中,也自然的将自个儿以为知道的事儿体系化条理化了
  • 因为,我们无法将自个儿的思绪整体用文字描述出来,这两者不是一个维度的事物
  • 只能,将思想,以假设读者的学识水平为出发点,模拟出一个自然的学习过程,来叙述
  • 这样才可能引导读者逐步理解到一个 概念/技巧/思想 的来由

综上:

为革命眼保健操开始!
不对
为成长持续写作开始!

参考:

• 珠的自白:27 技术人员如何坚持写作
• 珠的自白:23 我在剑桥学说话
• 海选文章:21 优秀亚裔都是”纸老虎”?
• 为什么不应该使用QQ进行技术交流

巡阅

• 150113 Zoom.Quiet checked