Throughout my career I have encountered other software engineers who do not document their code. These engineers have often argued against documentation beyond the code itself. They argue that their code is "self-documenting".

I have suggested that they take a look at some wavelet signal processing code. Looking at this code it is easy to understand what it does. But this does not help with understanding why the code does what it code.

Unfortunately, these arguments have fallen on deaf ears.

A good code documentation tool is great. But unfortunately it will not help with those who believe that their code is "self-documenting".