some minor tweaks to the documentation
tag v1.0