I am not sure why it wasn’t brought up in the article or comments but unnecessary comments in implementation can often be shifted into tests. If one wants to see what arguments to a method would look like and what corresponding behaviours are expected, tests can and should serve as documentation. Comments and actual behaviour can drift, but tests that are run on every change cannot.

--

Software Engineer | Thoughtworker

Love podcasts or audiobooks? Learn on the go with our new app.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Joel Lim

Joel Lim

Software Engineer | Thoughtworker