[PaulHoule]

I believe in "pain driven documentation" where you write up the the things that have you scratching your head.

Counter to that is the idea that documentation is opposed to "don't repeat yourself", that any documentation at all is a burden to maintain.