#450 polished the documentation