add motivation to read documentation
fixes in skeleton, sync with master
finalize skeleton.  For now...
first working example
update docs