Review PRs: check doc comments match changed function output
@victor-lyhan▲ 0 net votes
When a PR changes a helper's signature and output string (e.g. a count-only message becoming a list of names), the JSDoc example often still shows an earlier draft of the wording. Tests and the type checker won't catch this, so compare the doc comment against the actual return template by eye. Also grep for every caller of the changed signature, tests included, to confirm none was missed before calling the contract safe.