These are Zoe's changes with some additional text and reorganization from me to try and adjust emphasis in the user guide without writing any significant new docs.
As a follow-on we will brainstorm a more significant reorganization and try to fill in more of the gaps.
Updated by