Issue #101 XML docs

 - Updated README
 - Added doc to the XSD
 - Added an annotated example XML
perhaps this already exists, but a test case that loads this (and other example config files) is maybe a good idea, just to make sure our examples don't drift out of compliance with the schema some how