Clean up typos and some commenting style flakes.

Took the opportunity to look around the code base to fix some typos & make the commenting style a little bit more uniform (e.g. change function doc strings like 'does x' to doc strings like 'do x').