example code and documentation
- examples class and assertion-enforcing runner
- code in README.md now copied from working sources
[doc] language hints
[doc] minor improvements
merge pull-request from aztecrex