ソフトウェア開発者はしばしばブログ記事を通じて知識を共有するが、多くの人が書き手の効果を低下させる回避可能な罠に陥っている。もっとも一般的な間違いは、著者が本題に入る前にバックストーリーに時間を費やしすぎるだらだらとした導入部分である。この様子は図像IMG-002で示されている。リファクタリングイングリッシュの著者が指摘するように、読者はしばしば数段落読み進めたところで、著者が何を言おうとするのかわからなくなる。開発者は記事が自分に関係あるか、読むことで何を得られるかをすぐに知りたいので、タイトルと最初の3文は『この記事は自分と同じような人向けに書かれたのか？』と『読むことでどのような利益があるのか？』という質問に答えるべきである。この点については図像IMG-001を参照のこと。
もう一つの重要なアンチパターンは、用語をインラインで簡単に説明する代わりに、説明のためにリンクに過度に依存することである。ブロガーはしばしば読者が知らないかもしれない用語を挙げたいが、簡単な定義を提供する代わりにその用語にリンクを貼り付けて問題を解決したと考える。しかしこれは、読者の流れを断ち切らせ、記事から離れて単語一つを理解させようとするため、読書体験を悪化させる。解決策は、記事を理解するために必要な必須情報を要約し、外部リンクを前提条件ではなくボーナス資料として扱うことで、読者がリンクをクリックすることなく最初から最後まで内容を楽しみ理解できるようにすることである。
この画像は、開発者が記事の関連性と利益をすぐに評価したいという記事の点に関連しており、これはタイトルと最初の文に明確に現れるべきである。
この画像は、記事で議論されている、著者が本題に入る前にバックストーリーに過度に時間を費やすというだらだらとした導入のアンチパターンを示している。
過度の形式張りも頻繁に見られる問題で、初心者のソフトウェアブロガーは真剣に受け止めてもらうために硬く形式ばった書き方をしなければならないと誤解している。実際のところ、ソフトウェア開発の分野は白カラー職の中でも最も気取らない分野の一つであり、読者はパジャマとサンダルを履きながらキーボードの前でシリアルを食べていることが多い。彼らは法律文書のように聞こえる文章を期待したり望んだりしない。代わりに、ブロガーは現実生活での話し方と同じように書き、友達と昼食を取りながら話すようなカジュアルで親しみやすく気取らないスタイルを取り入れるべきである。このスタイルは、ジョエル・スポルスキー、キャシー・シエラ、テレンス・エデン、レイモンド・チェンといった著名なソフトウェアブロガーによって例示されている。