README: cleanup and update to spec