設定などを一部だけ紹介するときも全体のどこに位置するのかを共有する

例えばeslintの設定を記事に書く時こうやって一部だけオフにできます！

 {
      "files": ["src/pages/**/*"],
      "rules": {
        "consistent-default-export-name/default-export-match-filename": "off"
      }
},

とか言われてもこれどこに書くのか全体の中でどこに位置するのかわからない。

もちろん知識があればわかるんだけど、結構フラクタルになることが多いから同じ設定項目が階層違いで意味が変わることもある。
なのでこう書く。

{
//...
  "overrides": [
    {
      "files": ["src/pages/**/*"],
      "rules": {
        "consistent-default-export-name/default-export-match-filename": "off"
      }
    },
//...
}

//...はなくても良いが、こうすれば全体の中のどこに位置するのかがわかる。
既存のファイルからコピーすると前者のような感じになっちゃうけど、一手間掛けて後者の感じにすれば後の人（未来の自分）がハッピーになる。

情報共有「具体と抽象」、そして「過去と未来」を行き来する情報と知「言葉の定義」をはっきりさせるコミュニケーション会議をする前に、コメントする場所を作る(最悪会議しなくても良い)工夫は共有されるべき情報を赤裸々に共有する情報共有文の基本構成教え方が上手い人は何をしているか？目的のない（曖昧）な会議は無駄箇条書き、タスク形式で伝える 📐チートシート