We're working under the assumption that our code and function names are self defining. If you need to describe something in your algorithm that isn't obvious at first glance than by all means document it, but avoid documentation litter.