Quote
"You dont want to write a big comment that tells others how to make a change they might want to make, because you dont know what change theyre going to want to make. Better to have the attitude that you cant help future programmers make their changes. All you can do is make it easy for them to understand what you were trying to do. And it will be easiest for them to understand what you were trying to do if you were very careful to not try to do too much."
W
Ward Cunningham