Fix docs

Thanks Alley Stoughton for pointing out confusing/incorrect
statements.