some new helpers an readme fix