23.1Naming Conventions / Descriptive

説明的な名前を付ける

一文字の名前は避け、説明的な名前を付けます。

`q` や `i` のような短い変数名は、その変数が何を表しているのかを理解するために、周囲のコードを読む必要があります。`query` や `index` のように説明的な名前を付けることで、変数が自己文書化され、コードの可読性が大幅に向上します。（ループカウンターの `i`, `j`, `k` は例外的に許容されることが多いです）

❌ Bad

// bad
function q() {
  // ...
}

✅ Good

// good
function query() {
  // ...
}