Basic doc fixes

@greysteil Would you mind taking a peek at this? 
That makes sense - will do this later :smile: