> I am very qualified to state exactly where I am getting confused and where it could be better. alas, if I tried to write it, I would write incorrect explanation, which would probably be worse. so, this needs one person who is learning it (the consumer) and one person who is teaching it (the producer).
Well, I'd still recommend you try anyway. In the open source model, there is much less of a distinction between producer and consumer. Submitting a pull request to change the documentation is a good way of getting other people to tell you what is wrong with the current version. It usually only takes a few iterations to get it right (or at least to the point where there are no obvious flaws).
