General mild documentation oddities rollup

I have no clue why you were marked as a spammer. Your criticism is valid.