formatting, use definition.report
added some documentation
updated README