Improved commenting throughout the project. Fixes #18