updated readme, updated helpers