refactor spec helpers and use custom descriptions. add more object definitions from XSD