Basic doc fixes

@greysteil Would you mind taking a peek at this? 
Yeah, changed my mind - see the edit above!