在软件开发中，我们收集反模式来识别导致不良结果的常见特征。我认为对软件博客做同样的事情会很有帮助，所以我整理了我从初学者博主那里看到的最常见错误。
最常见的错误是漫无边际。开发者喜欢具体性，所以他们从背景故事和历史背景开始写博客文章。这写起来可能很有趣，但读起来并不总是有趣。从读者的角度来看，他们可以阅读的其他文章有数十亿篇。给自己标题和前三句话来回答：作者是为像我这样的人写的吗？我读它会有什么好处？
一些博主写了引人入胜的介绍，但用副标题、个人简介或图片等额外内容使读者的路径变得杂乱。你放在读者路径上的每样东西都会消耗他们有限的注意力。有效的教师会将新概念与读者熟悉的事物进行比较。例如，如果你在解释Jellyfin，你可能会说：“Jellyfin 是一个像Netflix这样的流媒体服务，只是它是开源和私密的。”尽量减少你对读者的假设。
当你写博客文章时，想想你的目标读者。他们知道什么？想象一个你在现实生活中认识的朋友或队友。列出他们能识别的术语和他们不能识别的术语。
来源: Hacker News · 由HeadlinesBriefing整理摘要