matthewkmayer / matthewkmayer.github.io

Web site, with words
MIT License
3 stars 1 forks source link

Check your work and make it easy to follow #107

Open matthewkmayer opened 3 years ago

matthewkmayer commented 3 years ago

Related to https://github.com/matthewkmayer/matthewkmayer.github.io/issues/83 .

A good bugfix includes a reproduction, hopefully in a test. See https://matthewkmayer.github.io/blag/public/post/red-green-bugfix/ .

An extra help is documenting reproduction steps so the fix can be verified. Black box testing: take these steps, see this incorrect result. Switch to the fixed version, follow the same steps, see correct result.

Following these steps builds trust with team members and users. Making a fix and not testing it can result in the problem not actually fixed because it wasn't tested. This erodes trust.