ソフトウェア開発では、悪い結果につながる共通の特徴を認識するためにアンチパターンを収集します。ソフトウェアブログでも同じことをするのが役立つと思ったので、初心者ブロガーから見られる最も頻繁な間違いをカタログ化しました。
最もよくある間違いは、話がそれることです。開発者は具体性を好むため、ブログ記事を背景ストーリーや歴史的コンテキストから始めます。書くのは楽しいかもしれませんが、読むのに常に面白いとは限りません。読者の視点からは、読める記事は他にも何十億もあります。タイトルと最初の3文を使って、次の質問に答えてください：著者は私のような人のためにこれを書いたのか？読むことでどのような利益を得られるのか？
一部のブロガーは魅力的な導入部を書きますが、サブタイトル、経歴、画像などの追加要素で読者の道を散らかします。読者の道に置くものはすべて、彼らの限られた集中力を削ります。効果的な教師は、新しい概念を読者にとって馴染みのあるものと比較します。例えば、Jellyfinを説明する場合、「JellyfinはNetflixのようなストリーミングサービスですが、オープンソースでプライベートです」と言うかもしれません。読者についての仮定を最小限にしてください。
ブログ記事を書くときは、ターゲット読者について考えてください。彼らは何を知っていますか？実生活で知っている友人やチームメイトを想像してください。彼らが認識する用語と認識しない用語のリストを書いてください。
出典: Hacker News · 要約：HeadlinesBriefing