updates to comments and readme