例を提供する

一つの具体例は一段落の説明に値する。特定の形の出力が欲しいなら、その形を見せよ。これは曖昧さを取り除く最速の方法だ。

データをいい感じに整形して。

このユーザーの配列をサマリーオブジェクトに変換して。

入力:
  [{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]

望む出力:
  { total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }

変換関数と、この例に合うテストを書いて。

例は、言葉だけでは曖昧に残る命名、構造、大文字小文字を釘付けにする。可能なら、例をテストとして含めよ——そうすれば「テストを通して」が曖昧さのない指示になる。この手は一般化する。サンプルのAPI(アプリケーション・プログラミング・インターフェース — あるプログラムが別のプログラムにデータを要求する仕組み)レスポンスはパーサーを釘付けにし、ビフォー/アフターの一対はリファクタリングを釘付けにし、スクリーンショットやASCIIスケッチはレイアウトを釘付けにする。ある形についての長い記述を書いている自分に気づいたら、止めて、代わりにその形の一つの実例を見せよ。