Feature/symmetric

Oliver, I'm not sure what happened with my previous pull request, but it appears that a few of my documentation questions didn't get included. Look at the net diff rather than the individual changesets.