I do get tone's point:
written by people who know exactly what they are writing about, but don't know how to translate it in a way most people understand 
There is no questioning the documentation writers' expertise in the subject matter, but I think it precisely because they are so technically accomplished that some of their thought processes don't make it to the written page.
I was helping (years ago) my young son with his school homework, - an essay. Having read through it, I mentioned that the second line needed a full full-stop on the end. I got on with whatever I was doing. A minute later I hear him ask, "Which end?"
Things are improving greatly though, which does take feedback of the minutiae to complete the whole. I do think that WA could consider hiring a writer who can think on behalf of the confused and frustrated and tell us which end the full-stops go at.
