例を提供する

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

Format the data nicely.

Transform this array of users into a summary object.

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

Desired output:
  { total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }

Write the transform function and a test matching this example.

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