A pull request that says a change is faster, or that coverage went up, or that a
suite is green, is a claim. The same sentence with the command that produced it
is evidence. The difference costs one line in a template and it is the largest
single defect class in work of this kind.
Done when
.github/pull_request_template.md exists and asks for what changed, what failure
it prevents, and the command behind any number in the body. It says plainly that
nothing reads it, so that nobody mistakes the template for a check.
A pull request that says a change is faster, or that coverage went up, or that a
suite is green, is a claim. The same sentence with the command that produced it
is evidence. The difference costs one line in a template and it is the largest
single defect class in work of this kind.
Done when
.github/pull_request_template.mdexists and asks for what changed, what failureit prevents, and the command behind any number in the body. It says plainly that
nothing reads it, so that nobody mistakes the template for a check.