写文章这件事
更新日期:
经验沉淀、定期思考,并以文章的形式进行记录和分享。工作中也一样,把许多经验整理成文档,当然也不乏“你工作就是写文章吧”这样的声音。至于为什么要这么做呢,我想谈谈我的一些想法。
程序员与文档的前世今生
我们程序员,最讨厌的就是看别人的代码,和没有文档。文档,其实是很小的一件事。项目也好,框架或是工具库都好,作为原作者或者踩过坑的,写文档其实并不会花很多的时间。
也遇到过,有人纯手动撸了一整个前端框架,好几个项目都在用,但是一句话文档都没有,甚至README
都没有。怎么启动项目?有什么注意事项?新人来了都重新踩一遍坑,和口口相传。
写文档,其实也是个思考的过程。如果在做一个项目或是工具之前,有认真做设计、做方案、横向比较业界方案,会留下有系统设计的相关资料。
但为什么就很多人不愿意做呢?因为觉得更新代码的时候,还要更新文档很麻烦;项目太紧急了,没时间写文档;因为觉得与我无关;因为我已经能徒手造轮子了,文档不重要。
我们常常把“麻烦”、“没时间”的罪名强加在文档上,却经常忽略了缺乏文档带来的效率低下、设计不合理导致返工和事故等潜在问题。
我们的人生,并不能只固执于当下的利益和输赢。同样的,写代码也不能抱着“有问题再解决”、“写文档并不能给我带来什么收益”、“说不定明天这个项目就不存在了”这类的想法,做一件事,需要努力地想着怎么做得更好,而不是抱着无所谓的心态。
遗憾的是,快餐式的消费习惯,渐渐已经成为很多人的生活和工作方式。相比于需要长时间持续沉淀和学习才能获得的技能,很多人选择了囫囵吞枣、先做再说的方式。
越来越多的人每天的时间都安排很满,从而觉得自己真的很忙。而社会从悄悄惩罚那些不努力的人,变成了悄悄惩罚那些不思考的人。
知识共享的世界进程
在这个世界里,我们每个人都是独立的个体,然后相遇并组成一个个的集体。
互联网早已经出现了,共享的世界也越来越近了。
分享,交流,共同成长和提升,在这样一个过程里,很多人会有所收获。
很多人怕被超越,便悄咪咪地把自己所学所有藏了起来。但真正的核心竞争力,即使你共享出来,也没有人能复制。因为那是你独特的人生经历、性格脾气形成的,没有两个人是完全一致的。
如果,每个人都把自己踩过的坑填了,把积累的经验都沉淀下来,我们在奔向美好未来的路上是可以越跑越快的。每个人都要学习的课本、所有出版的读物、科研界的成果,不都是这样的存在吗?
我们每个程序员都会去的 Github,不也正是这样的存在吗?
狭隘的视角,局限的只是自己。外面世界的步伐,并不会因为某个井口太窄而受到阻碍。
很多事物需要记录
很久以前就有开始,每隔一段时间就做一段生活记录,反思、想象、或是单纯的记录。
接触代码之后,发现要学的东西太多了,也开始慢慢记录踩过的坑、自身的理解、经验的沉淀。接手一个项目,也会习惯性地补齐 README 和一些相关的说明文档。试用框架、工具的新能力,也会顺便记下一些总结和心得。
这些内容,最终都会落到文章的形式进行沉淀。同时,也顺手扔到博客里,或者其他平台上,若能恰好帮上一些人的忙,便再好不过。
如果遇到的一些问题,都能在网上找到解决方案。如果找不到答案的一些问题,能在解决之后顺手写下来。那后面来的人,甚至自己又遇到一样的问题,不就可以很快地修复吗?
工作中,也会遇到很多的牛人。而并不是每一位大牛都喜欢做分享和写文章的,好些厉害的人都是自己默默地玩耍代码,很多的思考和想法都藏在心里,只有偶尔的交流和讨论才能接触到。“哇,原来还能这么做”,“哇,这想法好棒”,真正接触到的时候,禁不住会有这样的想法。
这些精彩的思考方式,优秀的设计模式,也都想要记下来。很多改变世界的念头,都是在思想的碰撞中产生。所有的这些,属于我的,不属于我的,也都想要写下来。
这样,即使没有站在巨人的肩膀上,也能依靠每个人上山的时候铺下的路,齐心协力地登上峰顶,看到最美的风景了。
结束语
到如今,博客也坚持写了3年多了,而一些生活相关的文章,也断断续续地记录了快 5 年了。
如果说最大的收获,大概是在这个过程中一边敲下键盘,一边进行思考而沉淀下来的反省。而一路上的历程,也能以某种方式能看的到自身的成长,慢慢调整方向,越走越坚定。
我觉得这是个很好的习惯,同样地也分享给你们。生活中,职场中,会遇到很多的低谷,依然希望你们能攀上顶峰。祝好。
——————————————————————————
我的工作和生活,界限分明。如果你想要关注非工作非技术状态的我,欢迎关注“牧羊的猪”公众号。
码生艰难,写文不易,给我家猪囤点猫粮了喵~
查看Github有更多内容噢:https://github.com/godbasin
更欢迎来被删的前端游乐场边撸猫边学前端噢
如果你想要关注日常生活中的我,欢迎关注“牧羊的猪”公众号噢