add an explanation of assertions, small RDoc tweaks
Merge branch 'master' of github.com:sshaw/test_xml