add readme
add clearer documentation