技术博客写作:先发布,再改进

发布于

Simon Willison 在一次关于技术博客写作的访谈中,回答了几类常见问题:

  • 为什么开始写博客,以及为什么持续写下去?
  • 写博客带来过哪些意想不到的影响?
  • 最自豪的一篇博客是什么,为什么?
  • 最难写的一篇文章是什么,又是如何完成的?
  • 有哪些经验教训值得分享?
  • 给刚开始写博客的人的建议是什么?
  • 平时喜欢阅读哪些博客?

其中,他特别强调了一条写作建议:降低标准

写博客最重要的建议是:降低你的标准。尽量在你对文章仍然不完全满意的时候就点击发布。否则,替代方案很可能只是一个堆满草稿、却永远没有文章发布出去的文件夹。

没有人会知道你原本打算写出的那篇“完美文章”会是什么样。你在自己文字里看到的缺陷,对其他人来说往往并不明显。

这条建议对技术写作者尤其有参考价值。很多技术文章并不是因为内容没有价值而无法发布,而是卡在“还可以再完善一点”“等我补完最后一个细节”“代码示例再整理一下”的循环里。

技术博客的价值,往往不只来自最终结论,也来自记录过程、问题背景、踩坑细节和当时的判断。与其等待一篇完美文章,不如先发布一篇足够清楚、能够帮助他人的文章。

浏览(8)
评论

请登录后发表观点

暂无数据