update readme according to spec compliance enhancements