more readme improvements

mostly still just an excuse to work out the bugs with the workflow