Documentation As a Bug-Finding Tool

New submitter Sekrimo writes "This article discusses an interesting advantage to writing documentation. While the author acknowledges that developers often write documentation so that others may better understand their code, he claims documenting can also be a useful way to find bugs before they ever become an issue. Taking the time to write this documentation helps to ensure that you've thought through every aspect of your program fully, and cleared up any issues that may arise."

Comments

Re:Common knowledge?

[Anonymous Coward]

Kudos to you if you can refactor the implementation in your head before you write it!

Re:Theory doesn't always work in practice.

[ThirdPrize]

Wrong. First you write the documentation, then you write the tests and then, if you have time, you write the code.