【早阅】什么造就了一篇出色的技术博客_AI阅读总结 — 包阅AI

前言

讨论了构成优秀技术博客的关键因素。今日前端早读课文章由 @排骨分享。

正文从这开始～～

我想解释一下，为什么我最喜欢的技术博客中的这些博客是我的最爱。该页面专门介绍非商业类的技术博客，所以这篇文章也是如此。我以后还会为我喜欢的企业技术博客单独列出一个列表。

简而言之，这些博客：

• 探讨复杂且令人困惑的主题

• 展示可运行的代码

• 使复杂问题变得更简单

• 定期写作

• 讨论权衡和缺点

• 避免使用网络用语、表情包、脏话、讽刺和抱怨

探讨复杂且令人困惑的主题

在编程和计算机科学领域，有一些问题，即使是知识渊博的程序员也不得不开始含糊其辞，或者退回到陈词滥调或群体思维，因为他们不确定这些问题的答案。

这些问题是你可以深入探讨的最佳主题。而我最喜欢的作者们正是这样做的。

他们写的是磁盘和文件系统的持久性保证。他们写的是基准测试中的常见陷阱。他们写的是数据库一致性异常。他们写的是线程和输入 / 输出 (IO) 模型。

而且他们通过展示具体的例子和清晰的逻辑来写作，这样你就可以学会如何在这些主题上停止空谈。

他们的写作帮助你形成一个可以应用于自己问题的有用思维模型。

有时，这并不是因为主题晦涩难懂。优秀的作者有能力以有趣的视角探讨一个看似无聊的主题。也许是通过深入挖掘根本原因，或者向你展示幕后的历史。

此外，我最喜欢的作者并不是全知全能的。但他们也不假装自己什么都懂。他们会迅速承认自己不理解某些东西，并向读者寻求帮助。

展示可运行的代码

我喜欢在文章中看到完整的可运行代码。相反，有很多项目一开始很简单，人们写了一篇文章，从高层次上介绍了该项目。但随着他们继续在项目上工作，项目变得更加复杂。

随着时间的推移，跟踪提交记录并不总是那么容易。

Eli Bendersky 和 Serge Zaitsev 尤其擅长在一篇文章或短期系列中开发出小而有意义的项目。

另一方面，如果人们只这样做，我们就听不到 V8 或 Postgres 等长期项目的开发进展。因此，我认为这种风格有其局限性。我并不会因为没有展示可运行的代码而责备那些谈论长期项目的人。

使复杂问题变得更简单

优秀作者的一个标志是，他们可以让复杂的主题变得简单，而不仅仅是简化。有时即便是过于简化，对于教育也不失为一种有用的方式。

相比之下，我有时会看到一些不太有经验的作者写的文章，惊叹于他们如何把一个简单的话题搞得如此复杂。我能认出这种情况，是因为十年前，甚至五年前，我自己完全就是这样。

定期写作

我最喜欢的博客通常每月至少会发布一篇新文章。有些人，比如 Murat，每周写一篇。

我认为这种练习确实能提高写作水平，但主要是因为他们通过定期发布文章来持续吸引我的注意力！

讨论权衡和缺点

没有什么比讨论你所创建内容的问题更能建立信任了。没有哪个项目是完美的。忽视缺点会让人觉得你不了解或不理解它们。

因此，我最喜欢的作者会在上下文中讨论决策。他们会谈论好的和坏的方面。

避免使用网络用语、表情包、脏话、讽刺和抱怨

我想不到如何在谈论这个问题时不显得非常无聊。

我注意到的一件事，特别是在年轻的同事中，是他们使用表情包或脏话，或者使用 4chan 的俚语，或者使用讽刺。我十年前也曾经这样写作。

你的一部分读者可能不会在意。问题是，也有一部分读者（潜在的）确实在意。甚至还有一些读者可能不在意，但就是不理解（例如，非英语母语者）。

我有一些朋友和我尊重的人，他们写作非常好。但他们写作时也过于、不必要地刻薄。我不喜欢分享这些文章，因为我不想无故冒犯或使人不快。

结语

如果每个人都以同样的方式写作，那将会很无聊。我很高兴互联网充满了乐趣和奇特。但我想分享一些关于我最喜欢的技术博客的特点，这些博客我总是乐于向人们推荐。

关于本文
译者：@排骨
作者：@Phil Eaton
原文：https://notes.eatonphil.com/2024-04-10-what-makes-a-great-tech-blog.html