Pull Requestの概要を書くときに、未来の誰かがそれを見ても内容が明確に分かるように、隠れたコンテキストをなくすようにしてみる。
例えば、大規模なリプレースPJをやっていたとして、そのPJを目下進めている最中はリプレース前後の設計の変遷などが記憶に定着しているため、Pull Requestの変更差分には現れない周辺領域への影響は、暗黙的に理解できているかもしれない。
その後、リプレースPJが終わって時間が経ったり、そのPJに関係なかった誰かがPull Requestを見た時に内容が理解できない可能性が高い。
これを防ぐために、隠れたコンテキストをなくすようにしてみる。
Pull Requestに限らず、ドキュメンテーションやプログラミングにも言えるかもしれない。