updated comments and docblocs for y'all