Merge pull request #766 from public/more-doc-tweaks

Various "improvements" to the symmetric docs