re-add stashed documentation updates for v2, wups