I have two comments on the current documentation:

1) It seems that the documentation is aimed at the developer with an average level of knowledge. Which leaves the beginner totally lost.

2) Many times the current documentation makes leaps of logic, and unless you can leap with it, you are out of luck.