#1380 polished the doc