It's true that there can be gotcha's in code which should be documented, but I don't think forcing a template on people is the solution. In fact, I wouldn't expect people to be better at documenting them with that in place.
And, yes, I don't like this either and would like a better solution. But so far I didn't get any viable suggestions.