Fixes after Loom API doc review

Building on top of @bengarney's doc pass. Fixed lots of typos and whitespace oddities, made a few additions and stylistic changes to at least have consistent styling within a file.

Please review before merging.