书评：《开发者内容创作指南》

我从事技术博客写作已经两年了，学到了很多东西。到目前为止，我的博客浏览量和评论量远远超出了我的预期。一开始，我只是把自己的想法随意倾泻而出，感觉还不错。读了《开发者内容创作指南》之后，我又想起了最初的那些想法，它给了我新的启发。

我喜欢看人们在博客上分享他们的爱好和想法，尤其是在个人网站上。个人网站既酷炫又独特，让我觉得上网更有乐趣。如果你的个人简介里有链接，我很有可能会点进去。

在这个安静而异常寒冷的星期天，我非常高兴地看到，对于那些刚刚踏上这段旅程的人来说，有很多资源可以帮助他们！

博客入门最佳指南

毫无疑问，《开发者内容创作指南》是那些想要开始为开发者撰写内容的人的最佳资源。在阅读这本书之前，我列出了一份我认为这类资源应该涵盖的主题清单，而这本书恰好满足了我的所有需求。莫里洛的文笔清晰流畅，引人入胜。她不仅告诉我们如何撰写易于理解的内容，还告诉我们如何避免犯错。

• “只需按照这些简单的步骤操作即可”
• “组装起来很容易”
• 答案显而易见。

我发现很多技术内容的作者会使用这些词语，是为了让读者觉得内容不那么晦涩难懂。他们的确想为用户消除障碍，但他们使用的语言却让读者觉得问题出在自己身上。

资源丰富

《开发者内容创作指南》还包含大量工作表，可以激发您的灵感，帮助您制定策略并编制内容日历。

本书各章节都附有相关资源链接，并提供了一个示例，说明如何以更清晰的方式在文章中插入资源。例如，可以参考 Morillo 的示例，以 GitHub 的热门页面为例。

• “GitHub 上有一个热门代码库列表。点击这里查看。”
• “浏览GitHub的热门代码库列表。”

对读者而言，第二个版本读起来更流畅。

Morillo 推荐了一些全面的资源，例如DigitalOcean 的技术写作指南，以及一些只需几秒钟即可设置和运行的工具，用于辅助您的写作。

AlexJS是一款开源工具，可以帮助您“发现不敏感、不体贴的文字”。

Hemingway App是一款在线编辑器，可以帮助您简化写作。它会突出显示令人困惑的部分、过长的区域等等。

我个人也建议，阅读其他技术博客是个不错的资源，我推荐 Hacker Noon 的“年度最佳个人开发者博客”入围名单作为入门参考。Drew DeVault 发布的内容很棒，他偶尔会向在开放平台（例如非 Medium）上创建技术博客的人支付 20 美元。谷歌也发布了一门免费的技术写作课程，不过我认为它更适合撰写技术文档的人。

柱子的形状

Morillo 经常谈到技术博客的阅读方式以及它们在用户眼中的呈现方式。

在开始写作之前，你需要了解人们如何在线阅读。人们不会逐字逐句地阅读；他们会快速浏览。他们寻找的是最相关的信息，那些吸引他们眼球的内容会抓住他们的注意力。

在编辑阶段，思考文章的结构很有帮助。它能帮助你简化复杂的内容，吸引那些原本会略读大段文字而放弃的读者。它还能帮助那些只想找到解决难题的那一行代码的人。

提醒我们，人们会浏览“关键词、章节标题、项目符号、锚文本（当有超链接时）、加粗或斜体字以示强调的词语”。

《开发者内容创作指南》涵盖了我脑海中尘封已久的诸多主题，并提供了宝贵的真知灼见。即便在我撰写这篇文章时，我仍然在思考莫里洛的建议。正因如此，我向所有为开发者撰写内容的人推荐这本书，无论他们的经验如何。它改变了我为个人博客和公司博客写作的方式。

继本书之后，莫里洛目前正在撰写《开发者图书出版指南》——我非常期待这本书！

已有 200 多人订阅了我的编程和个人成长简讯！

我会在推特上发布关于代码的内容，账号是@healeycodes。