documented some code. inspired by hiccup style
update readme