2018.12
2019.02
2019.05
2021.01
最近时不时就会有一丝恍惚,想问自己,技术写作的初心是什么?或许是为了记录,代表自己曾经来过,或许是为了积累和分享,给自己带来成就感,也或许它早已成为了一种习惯。 从21年上半年停更到8月底,忙碌之余我就在想,我的写作好像进入了为写而写的怪圈,像是完成一些定量的任务一般,所以文章的质量也忽上忽下。还记得我当时写作的初衷是希望文章对自己有帮助的前提下,还能对别人也有一些帮助。现在这种被动输出的诡异感觉,似乎在提醒我,该停一停了。 工作也好,学习也好,一股脑的向前冲是不理智的,你要时刻掌握自己思想的主动权,明白自己走的意义,及时选择自己认为正确的路,及时根据客观回响修正自己的方向。再将自己的热情投入,否则只是一腔热勇的傻小子罢了。 所以我停了下来,思考自己的路应该在哪里。
“限时领取,阿里技术专家内部资料 24 小时删除……”,“字节新宠火遍编程圈 ……”,“面试官问我做过什么项目,我这样回答……”。当你情不自禁的点击进去后,最后等着你的一定是一张大大的卖课/引流二维码。各种标题党、广告、营销手段,最终堆起一个又一个大 V,而让一些真正有实质输出的博主,淹没入铺天盖地的垃圾信息中。让读者也逐渐失去了兴趣,也让公众号技术类文章的权威性大大降低,毕竟公众号的最大便利在于基于微信,很方便,但却持续获取到的是一群没用给的信息,只会让人心生厌烦之心。
客观的讲,一些比较大的培训机构对于入门某一块技术的时候,还是挺有帮助的。但是同样是因为各种营销的介入,培训班各种铺天盖地的系列框架,各种中间件,分布式,往往会让人心生畏惧。对于一个学生,一个刚入门的小白,看到这样的场景,总会给人带来各种焦虑。而与此同时,他们往往会把这些课程与就业、工资等敏感话题挂钩,给人一种只有学完这些东西,才能找到好工作,高工资。然后就会有无数的人投入到对框架技术的狂热之中。然后云里雾里的配一下环境,然后跑一些 Demo,就代表学会了。至于用在什么场景,为什么用,有没有更好的方案,也并不清楚。好像有一种学过,但是又没学会的感觉,也是徒增焦虑。
当你无论是百度还是谷歌一个问题的时候,首先展示给你的都是一些权重比较高的站点信息,例如 CSDN,博客园等等。但是这些大平台的数据实在太多了,优质答案肯定是存在的,但是 copy 的更多,点好几个页面进去都是同一份答案。更可恶的是,一些网站应该是用爬虫等自动爬数据,直接把文章导入到他们的网站,然后图片因为原网站防盗链,大部分还是失效状态,阅读感极差。最后的结果就是,例如搜索 “如何配置 XXX”,最后第一页往往是大量重复的无效信息。效率低下。
我认为,优质文章(100%) = 技术(70%) + 文笔(20%)+ 美化(10%)。 从我的经验来看,随着学习而记录下来的内容,更准确的应该叫做笔记而不是文章。它更多的是对你个人学习过程的一个记录和备忘。如果作为文章来看,宽度和深度都一定程度上的不足。这也就是 “对自己有用,对别人没用” ,但是能做到这一步,我认为与你个人而言已经有很大帮助了。如果想要对别人也有帮助,就需要对这块的技术进行应用 + 深耕,只有自己切身体验过,研究过才能知其然,更知其所以然。 而文笔,就是你冲向终点的一把助力,拥有一定文笔的人,才能知道如何精炼的表达,如何在复杂的技术中寻找联系和结构,如何通俗易懂,简洁明了的描述这个技术。文笔使人阅读不枯燥,文字不晦涩,吸引你的读者继续阅读你的文章。 当然,必要的美化也是需要的,人都是视觉动物,排版的整洁,代码的高亮,图片的清晰度。都会直接影响到读者有没有读下去的心情,但是我想知道,美观大方 ≠ 花里胡哨,切莫为了美观而失去了技术的本质。
很多时候,我们并不想深度的去阅读一些文章,我只想进行一些轻阅读,或者只想快速的找到答案,那么即使是长篇的优质文章,对于当事人来说也同属无用信息。这一点,其实很多社区,例如掘金,思否等等,都是有的。这一点也应该理应延续。
你的脑海中知识要有体系,你的记录同样需要,但是随着你知识面变广,或者随着对技术点的深度挖掘,你的知识体系结构也在不断的扩容和修正,但是当你到达某一个阶段的时候,你似乎会发现曾经自己的知识结构对于现在的自己,似乎已经并不合理了。所以本地写作上,对于文件地址和结构的安排变更就会受到一定程度的影响,这也是下面在第四大点我会提到的。
再补充一个概念——可迭代,可能大家会第一反应想到 GitHub,对的就是它的概念,我还记得在我刚上大二的时候,我一直有一个念头,我能不能开发一个可多人写作的知识管理平台,无论是组的概念,还是面向全部互联网的概念,这不重要,我只希望知识也可迭代。否则每次发布一篇完整的新的文章的成本和重复率就会比较高。如果可迭代,就能不断的完善修改这篇文章,从而拿到知识的最优篇。
我可以给大家阐述一下这些年我用的最久的方案:
接着我来分析一下利弊:
首先,我试图摈弃掉本地笔记的写法,好处就是不再需要维护本地的各种文件,图床也不用考虑了,特别的是,修改结构似乎会变得简单一点。 接着,我考虑精简输出的平台,只保留个别,同时尽可能的简化非写作本身的繁琐步骤,回归写作本身。经过一段时间的比较,现阶段的写作平台和方式如下:
总之,最大的改变就是舍弃了过去本地笔记的写法,对比了多家平台,选择了语雀作为主力写作平台,或许阅读和访问的流量就没有以前那么高了,但是能够投入更多的时间和精力到写作本身,利大于弊。