incorporate REST/doc feedback