refine doc according to review comments