写这篇文章之前,我先道个歉:下面这些内容没有经过任何工具处理,没有语法检查,没有AI参与,也没有为了流畅度做过编辑。读起来可能有点粗糙,但这恰恰是重要的。
熟悉我的人都知道,过去8年里我写了数百篇文章。在创建SolidJS的早期,我就意识到教育将是一个根本性的障碍。React的话语体系已经占据了前端领域,以至于对不同想法的讨论并不受欢迎。事情可能始于理念之争,但向现代工具链迁移的复杂性让许多人感到不知所措。"JavaScript疲劳"这个说法当时正流行,那些没能在2016年之前赶上浪潮的人,都深受其苦。
![]()
早期的写作,真的非常粗糙
我早期的写作很粗糙,真的很粗糙。我试图表达自己的想法,但这些想法很难转化。并不是我的英语能力不行——我在学校一直表现不错。但我想表达的想法超出了代码示例的范畴,它们借鉴了多年的观察和跨学科学习的积累。我需要用整篇文章的篇幅才能把观点说清楚,而且读者很容易在细节中迷失。
更糟的是,我写作的方式就像我说话的方式——相当跳跃。当年在ICQ和MSN上打字聊天时,我习惯用"."来向对方传达节奏感,"..."越多表示停顿越长。在工作中我当然需要沟通,也逐渐习惯了平均每封邮件重写三遍,只为删掉那些不必要的内容。
2018年,我开始在Medium上发表文章。幸运的是,Solid早期社区在Gitter和Spectrum上开始给我提供编辑建议。这种与社区一起审阅文章的模式从未消失。直到今天,我的大多数文章在发布前几天,都会先出现在Solid的Discord服务器上。
Grammarly带来的突破
后来,一位社区成员建议我试试Grammarly。说实话,帮助真的很大。我总会在某些地方漏掉单词和逗号。即使用的是免费版,它也会在我用词别扭时给出提示,让我至少有机会改写一下。
这确实有改善,但说实话,它解决的问题比你想的要少。我并没有掉进那些简单的陷阱里,但写作并没有变得更清晰。真正的突破发生在2019年左右,我的作品开始通过在线出版物发表,特别是"Angular in Depth"。他们非常支持我的内容,但他们看到了问题所在——文章缺少与读者的连接。
我记得有一次,@layzee坐下来和我一起逐段分析一篇文章,教我如何把内容拆分成更多段落。我习惯用一个段落表达一个我认为完整的想法,这意味着每段有6-8个冗长的句子。他说,不要超过3句。给读者一个喘息的机会,让他们消化你刚说的内容。增加段落间距和图片,让内容更有呼吸感。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.