made a few updates to comments for better documentation