100 times "yes"! And, I think, I had mentioned before:
1. first of all - short descriptions (general idea) of all classes.
2. a small good example is worth of 1000 words.
Well, I guess, we did agree on that, however, there still needs to be a form of "reference", listing all methods...