some improvements in the docs.