doc fixes; examples are now compiled with test classes
initial readme update
readme updated; docs updated; IRunner interface added;
minor refactorings; docs improved
transition docs added
minor bugfixes
Merge pull request #2 from eug/dev

Merge dev branch