more tweaks to bring README inline with acceptance specs