I disagree. There's nothing at all wrong with describing the function
itself and what it does and how it works.
Of course not! But it's critical to separate the *specification* and
*implementation* of a function and when you put them both in the same
comment, you aren't doing that.