原文拜见本人博客:技能写作的“坎”

关于还没开始写作的程序员来说,开始动笔总是很难的,有各种心理的坎需求过:

  • 作为理工科学生,曾经作文写得就很差,现在还让我写技能文章,快算了吧
  • 网上有许多类似的文章,我再写一篇没有任何含义,况且我写的还不如人家好
  • 我的观念不必定彻底正确,会误导看到的人,特别是一些初学者
  • ……

这篇文章我们就聊聊程序员写作时心理上的这些“坎”。

写欠好作文,怎么能写出文章来

我个人的观念是写技能文章并不需求好的文笔,能用通畅易懂的语句把意思说清楚,逻辑表达清楚就足够了,好的文笔对读者来说确实能够带来好的阅读体会,但好的文笔也不意味着需求用富丽的辞藻,关于技能文章而言,我一直觉得文章的逻辑规划远胜于其他。

文笔并不是初写文章时该考虑的,关于这个“坎”来说,写作志愿度是要害。“牛不喝水强按头”,写出来的文章估量自己也不愿意再读。

日常的工作中,我见到许多搭档用文字记录下自己的考虑:

  • 比方解决问题后用文章记录下问题的识别,确诊考虑进程,根因分析以及自己的总结
  • 比方学习了一门新技能,使用到项目上,写篇文章记录下怎么设置环境,怎么运用,以便利他人
  • 比方参与到一次有技能应战的项目中,用文章记录下整个进程,计划的难点以及自己的考虑
  • 比方结合多年的项目经历,把自己针对某一个技能领域的考虑收拾成一篇文章

上面多次说到一个词:考虑。写作是一种创造活动,即使同一个话题,不同的人写出来的文章也必定是不相同的,这里面的差异就在于不同的人考虑问题的视点和重视点是不相同的。写作的进程也是再次深化考虑的进程,把自己的一个想法更深化地收拾成一个完好的逻辑链,写作就是证明这个想法在逻辑上成立的进程。

写作进程促进作者深化考虑,关于作者是受益匪浅的。回到 写作志愿度,程序员应该更重视写作能给自己带来的优点,重视写作对考虑才能的提高,重视写作有助于常识进行系统化收拾,而不要写作当成作文相同的任务或许必答题,给自己强加一些心理上的暗示。

工作中多考虑,多尝试解决问题,必定会发现许多有牵动的**“想法”**,尝试抓住这些想法,记录下当时的想法,收拾下逻辑,文章天然就写出来了。

同类文章许多,为什么还要写一遍

辛辛苦苦写完一篇文章,天然而然会有一种成果感——创造的成果感。或许会在小范围分享,让更多人看到自己的成果,或许期望自己的文章能够被更多人看见,提高影响力。

然而,查找引擎的强壮在某种程度上摧毁了技能写作者的动力和成果感。试想一下,当你想把突发奇想的想法写成文章,查找发现类似的文章现已在网络上存在,质量也不错,顿时就会失去写作的动力。有人写过了,为什么还要写一遍,浪费时间不说,发布在网络上也恐怕会有抄袭的嫌疑。

这道“坎”挡住了许多想成为技能写作者的程序员,查找引擎是程序员最强壮的东西,好的程序员必定是拿手运用查找引擎解决问题的。但查找引擎同时也出现了网络上的海量信息,似乎网络上的信息现已囊括了这个世界上一切你能想到的工作。

但回到写作自身,我们把自己内心有牵动的想法写出来,通过深化考虑形成文章,如果不是有意参考,这个创造进程很难产出十分类似的文章。究竟写作者的经历不同,常识结构不同,萌发想法的场景和上下文不同,产出的文章必定是有差异的。就像写代码,即使是如出一辙的需求,不同的程序员写出的代码从结构规划、代码风格和代码质量上也是有很大差异的。

技术写作的“坎”

这里的要害点仍然是作者自己的深化考虑,如果仅从一个小想法开始,就说自己写出的文章和网络上的文章没有太大差别,这个结论下得十分武断。任何一次认真的考虑都值得被尊重,读者会从文章中看到作者的独特视角,看到作者的感悟。在技能领域,相同一件工作,能够有十分多样的视角和表达,就拿编程言语来说,一门编程言语的经典书籍也会有许多:由浅入深的,进阶的,专门讲规划思维的,专门讲怎么使用的,等等。

写作是训练作者深化考虑才能的活动,也是促进作者学习的活动。写作进程中或是为了让逻辑更加谨慎,或是为了观念的证伪,都需引进更多的威望或经典资料,这个进程也在检验作者本人常识的系统性,进而促进作者在写作进程中学习更多的常识。

个人观念未经时间的验证,怕误导读者

另一个阻碍程序员把自己的观念写成文章的“坎”源于程序员“善良”的本心或许“责任感”,不期望自己的观念误导读者,特别是关于一些处于入门阶段的初学读者。

先从读者的视点来看这个问题,即使是初学编码,作为一个合格的程序员,首先应该是有思维能够独立考虑的个人。回想我们作为一个初学者,必定期望能够跟更多有经历的搭档沟通,学习他们做事的方式,学习他们解决问题的思路,学习他们脑子里对技能的了解。当我们要把这些常识用在工作中,就需求结合自己的了解,用自己的言语把学到的常识说清楚。如果一挥而就彻底照搬别人的说法或做法,只会用Ctrl+C,Ctrl+V工作,那即使传授经历的搭档每句话讲得都十分谨慎,他也很难把工作做好。

程序员的经历生长是需求像游戏里打怪升级相同一步一步来的,没踩过坑也体会不到别人总结出来的经历有什么价值,踩过坑就会有自己的考虑,就会知道任何技能和常识的使用都是需求权衡的,这个世界并没有银弹。

再回到作者的视角,我认为写作并不是教学进程,而是一个表达进程。写作的本质不在于传递百分之百正确的观念,更重要的是在文章中能够展示出程序员独特的考虑方式和技能视角。因此,文章中可能有一些不当之处并不是什么大问题,反而可认为读者供给更多的考虑空间。作者应该考虑的是怎么通过写作把自己考虑问题和解决问题的思路以相对客观的言语来表达出来,让读者能够读完有所启示,但绝不是让读者彻底照着文章的内容去抄。

小结

就像前文中写到的,任何一次认真的考虑都值得被尊重,程序员能够把技能写作当做一个加快自我学习和提高的东西,借助写作构建自己的常识系统,借助写作训练自己的深化考虑才能,借助写作来和文章的读者切磋技能,借助写作打造自己的影响力,借助写作强化自己的心脏,抛开那些无谓的“坎”。