doc refinement