Code cleanup

This MR cleans up the existing code. It

• Adds comments to all of the major classes and public methods.
• Explains particularly tricky parts of code.
• Transitions a few remaining fields to being private and relying on access methods.