updated readme and added comments to example.xml