further documentation tweaks