Issue #101 XML docs

 - Updated README
 - Added doc to the XSD
 - Added an annotated example XML
Done... and found some interesting bug I think. A missing class sometimes is just treated as "null", and if that's an acceptable default, that's what it'll be... I guess we want to change that. I'll create an issue for this