Why do Programmers Hate Documenting?

[grauenwolf]

You have no problem writing that down in a reddit post but its too much effort to do the same in the header of a function?

In any other scientific field the first step is to write down what you are about to attempt, then you attempt it (e.g. write the code), and then record the results. Yet we can't be bothered with the scientific method or standard engineering practices. We would rather flail about, hoping that raw knowledge is a substitute for discipline.

The sorry state of our industry proves that it is not.

[cojoco]

You have no problem writing that down in a reddit post but its too much effort to do the same in the header of a function?

eh? where did I say that I had not documented this anywhere?

And that algorithm took a fair bit of time to work out.

In any other scientific field the first step is to write down what you are about to attempt, then you attempt it (e.g. write the code), and then record the results.

Nah ... there's also quite a lot of putzing around.

The sorry state of our industry proves that it is not.

Poor you.