big commit

lots of added detail