update comments and README