add more tests from UTS #35 examples
update docs (readme is now markdown)