Actually, I am quite good at writing docs. That is why I hate mandated comments in certain places. I would like to write better docs than that. In fact your com

Actually, I am quite good at writing docs. That is why I hate mandated comments in certain places. I would like to write better docs than that. In fact your comment tells me you (or perhaps your colleagues) are the one who is terrible at writing docs. "because then nothing will be documented" says it all. I actually would write docs voluntarily and they would actually be helpful. Why focus on that one? Because it turns out that rule will force me to have 50% of the text that I see in a file be these useless comments.