The comments that go into code versus those that go into the pull request description
Summary
The article explains the distinction between what belongs in a pull request description versus comments in the code. It provides examples and guidance on durable in-code documentation versus time-bound PR notes, plus best practices for what to include and where to put it.