I'm sorry to say that I must be blind too, unless we're actually both right. More than that, I agree with your other thoughts too.
I did send a message to the documentation team offering to get involved in writing such documents, ie how things actually work rather than simple explanations of how some, hopefully common, things can be written. Unfortunately that was two weeks (?) ago now and I've not had any reply.