I don't think doc comments are warranted in every case and definitely don't think you need to document every single parameter, return value, etc. for every sing

I don't think doc comments are warranted in every case and definitely don't think you need to document every single parameter, return value, etc. for every single function, but they sure do come in handy for complicated APIs.