Added comments and clarification

Primary code files updated to include better, more comprehensive
comments to outline methods and fields.