Issue #101 XML docs

 - Updated README
 - Added doc to the XSD
 - Added an annotated example XML
Any chance services could come after caches? The only reason I ask is that when I first look at this example I see some stuff for jsr107 which I'd rather people not see *first* 

just a thought