Personally I like commenting what the function does instead of how it does it.

With the example section, you might want to add to it sample input values and the output of the example input.

One thing that I do is put the comments through a spell checker. But then I am a terrible speller. *grin*
--
Mortic