add very high level documentation

Mostly mention all the high-level components and the overall
data/control flow that would happen during normal operation.
try to link documentation
Merge pull request #2 from andreashappe/master

add a little bit of high-level documentation