DOC: tweak doc to address review comments.