best practice doc update