Of course, we have to expand such part. There are many discussions about it, maybe a wiki could be a nice solution writing some examples that integrate manuals. Would you like to help us? Your point of view is really important, we need a doc more complete and straightforward.
We must organize the doc
Does the Github wiki is really shit?
Explaining e-smith layer - learning by doing