improve readme and error on bad configuration