Today I was asked why I comment so much in my samples, and the Gist that I publish here.
The answer is very easy: The comments should educate everyone a bit (more)!
I know that there are a lot of redundancies and that not every comment makes perfect sense.
A lot of the samples are part of my workshops and showcases. How should I teach others how to write Scripts and build their own tools of the code is not documented well?
Two quotes to think about:
The sourcecode is documentation enough. Unknown developer
It was hard to write the code, so it must be hard to read it! Unknown developer
And to be honest: I think if the comments are too much, just remove them!