docs refinements