#450 polished the documentation and moved it into the docs section