[SQUASH ME] some fixes to documentation