readme and changes to spec