major readme update plus a few minor changes