updated comments and README