Code review: add docs, tweak whitespace lines