Docs: More Consistent JSDoc comments

[seangwright]

The language describing methods/parameters/return types isn't very consistent across the library.

We need to decide on a few things and then clean it all up:

• Past/present tense
• Verbose vs terse method description
  • Details in description or param/return type annotations
• Comments just for method overload signatures or also for implementation
• Comments on utility types