final piece of the big documentation push; almost certainly there will be tweaks, but the big effort is done