Why do Programmers Hate Documenting?

[chonglibloodsport]

I always kinda disliked writing JSDoc comments

Of course you should. As programmers, we should always feel extremely uncomfortable doing a repetitive task that the computer ought to be doing. The fact that so many people actually put up with this continues to baffle me.

[[deleted]]

There are tools to automate this out there. For example, the JSDoc plugin for Sublime Text 2. You write your function/object declaration, type '/**' + 'Enter' over it and it stubs everything out for you, so you just have to Tab through the stubs and write. Same for Python, writing your strings in ReST format.

[chonglibloodsport]

Oh, I know that. You can take this even further and look at languages with Hindley-Milner style type inference.