[docs] Touch up a few flaws in the documentation