io-oi.me
io-oi.me copied to clipboard
reuixiy
为什么要写教程？
在国内，很多厉害的技术人员不屑于写通俗易懂的教程，这其实是不对的
- 柏拉图的「洞穴比喻」。自己寻得洞外的真理后，还有一个回去的过程，即去引导那些尚不知洞外之真理的人走出来。因此有人认为伦理学是哲学的最高成就，造福这个世界的是伦理学，而非形而上学。
- 只有去传播、去普及你的发现和创造，你的发现才有价值。正面的例子是孔子，反面的例子是亚历山大图书馆的毁灭——不向大众普及知识，最终知识被无知的大众毁灭。现在的例子是 Conference，很多技术大牛成为了布道者；开源项目的商业化，比如 Gatsby，从一个开源工具到提供相应服务以逐渐成为一个品牌，这样的商业化一方面对自己有利（影响、收益），更重要的一方面是将这种优秀的工具利用自身的影响和商业的优势传播出去，带动整个行业的进步，从而有利于整个行业。试想如果 Gatsby 和其它 SSG 一样，只是 GitHub 上的一个开源项目 + 一个官网，那么它的用户可能在很长一段时间内只会限于少数的技术开发人员，而不会被很多公司使用。这一方面自己的影响力小了，无法让这个世界受益于自己的优势；一方面自己可能在快速发展的技术世界迅速沉没，开发人员慢慢感受不到它的价值，最终很快成为一个废弃项目。
- 能力越大，责任越大。你有这么厉害的技术，你就应该承担起传播这一技术的责任。这是被动的消极意义上的。
-
写的时候能将自己朦胧的知识变清晰。
-
写完发布后
- 激素激增，驱动自己将文章改进甚至改正到完美；
- 大脑活跃，文章内容在脑中一遍一遍重复，加深记忆，加深理解，推动联想，激发灵感。
音乐，最好的备忘录，最好的催化剂。
并不是表达得更好，而是 writing forces clarity 是一种更为积极主动的说法，相比另一种说法——写给大家看、要发布出来——这是一种消极的说法。可类比于「己所不欲，勿施于人」的消极和「己欲立而立人，己欲达而达人」的积极。
writing forces clarity，并非我他的积极消极之分，而是物质的客观。所以，也的确是表达得更好。
当时此反驳一闪而过，却被自己的急躁堵在了一边。