Documentation fixes & two resharper suggestions

Just had the file open and discovered some subtleties.
I hope it's okay to join the two independent commits into one pull request.