update docs. add idiomatic example. document hoe().