increasing documentation, removing direct access to class members, and removing deprecated category methods