Coding and commenting style fixes and documentation updates

Taking baby steps to improve documentation and commenting style.