massive documentation update

Starting a pending pull request for this work.