add the hiptionary
clean up and add example