update to readme, update to reasons output, and update to example commands document