updates to comments and README