Doc minor fixes

Fixes some of the quirks I came across while reading the documentation
Good catch. I am surprised that this passed the doctests.