The docs stomped me, too. I sent suggestions for metaphors and such that might help confused people. They're hard at work on the issues from what I've seen, though. So don't give up yet: check back in a year or so to see if revisions bring you extra clarity. :)
