update readme
rename functions to better reflect their purpose