review readme and XSLT conventions