refactoringenglish-com

このエクササイズは、ソフトウェア開発の文脈における受動態の認識能力をテストします。各文章について、受動態が含まれているかどうかを「アクティブ⚡」または「パッシブ😴」で選択します。

このノートはTyler Ciprianiの記事「Gitにおける大規模ファイルの未来はGit自身にある」の初稿に対するブログ編集ノートです。編集を通じて、対象読者の明確化、実践的な教訓への焦点化、明確で直感的な構造の確立を支援しました。完成した記事はHacker News、Lobsters、/r/git subredditでそれぞれ1位を獲得する高い評価を受けました。

多くのソフトウェアチュートリアルには欠陥がありますが、初心者向けに書く、明確な結果をタイトルで約束する、コピー＆ペースト可能なコードスニペットを作成するなど、いくつかのシンプルなルールに従うことで優れたチュートリアルを作成できます。これにより、平凡なガイドの中から際立つことができます。

高校の英語教師は受動態の危険性を警告し、大人になると受動態はクールだと言われますが、ソフトウェア開発者なら受動態の使用をやめるべきです。受動態と能動態の違いを理解し、明確なコミュニケーションのために能動態を選択することが重要です。

このエクササイズは、ソフトウェア開発の文脈で受動態を認識する能力をテストします。各文章について、受動態が含まれているかどうかを「Active ⚡」または「Passive 😴」で選択します。

効果的なコミットメッセージはコードレビューを簡素化し、長期的なコード保守を支援します。20年のソフトウェア開発経験に基づき、有用なコミットメッセージの構成要素と、コード変更の目的・影響・背景を明確に伝える方法を解説します。

この記事では、Hacker Newsで人気のある個人ブログをランキング化するための方法論を説明しています。個人ブログの定義、スコアの集計方法（20ポイント以上の投稿のみを対象）、ドメイン移行時の扱い、および500ポイント以上のドメインのみをデータセットに含める基準について詳細に解説しています。

開発者向けブログ記事を書く際のよくある間違いとその修正方法について解説します。興味深い洞察があっても、提示方法に問題があると読者を遠ざけてしまいますが、これらのエラーは簡単に修正できます。

リリース告知は、ユーザーの体験が昨日よりも今日どのように改善されたかを示すものです。多くの告知は単なる変更履歴の羅列に終わっており、実際のユーザー視点が欠けています。効果的な告知は、ユーザー中心のアプローチで新機能の価値を伝える必要があります。

ソフトウェア開発者にとって、効果的なメールを書くことは非常に価値があります。良いメールは時間を節約し、誤解を減らし、会社内での評価を得るのに役立ちます。

著者は『Refactoring English: Effective Writing for Software Developers』という本を執筆中で、進行状況は約50%です。これまで自信のある章から書いてきましたが、残りの章について読者が実際に学びたい内容かどうかを確認するために、読者のフィードバックを求めています。

開発者兼ブロガーのアダム・ゴードン・ベルが、ブログ投稿を通じて顧客を獲得する成功手法について語ります。Hacker Newsのトップページに掲載される記事の書き方、潜在顧客を惹きつけるトピックの発見法、ライティングスキル向上のテクニック、競合他社について敬意を持って書くことの価値など、実践的なアドバイスを共有しています。

著者は20年間で数千のソフトウェアブログを読んできたが、特に記憶に残り思考を変えた10の重要なエッセイを紹介。ジョエル・テストから「退屈な技術を選べ」まで、ソフトウェア開発への影響力のある作品を厳選。

ソフトウェアプロジェクトのデザインドキュメント作成後、チームメイトから有益なフィードバックを得る方法と、デザインレビューが数ヶ月も引き延ばされるのを防ぐための実践的なテクニックを紹介します。著者の経験に基づく効果的なレビュープロセスを提案します。

Bob Nystromの『Crafting Interpreters』はプログラミング言語をゼロから構築する方法を教える書籍で、そのイントロダクションは特に効果的です。開発者向けの導入文として、簡潔で魅力的な書き方を研究する価値があります。

2025年にHacker Newsで最も人気のあった個人ブロガーを分析。個人としてブログを運営する著者を対象に、企業やチームのブログとは区別してランキング化しています。

20年の開発経験を持つ著者は、明確なライティングの重要性を強調。技術的なプログラミングにおいても、文書化やチーム内での知識共有のため、ライティングスキルの向上は開発者にとって重要な「ソフトスキル」であると主張。

著者は同じオープンソースWebアプリの設計文書を3種類作成：人間が16時間かけて手書きしたもの、Claude Opus 4.6で生成したもの、GPT-5.4で生成したもの。AI版は数分で作成され、AIエージェントは著者の手書き版を見ずに生成した。