improve formatting and add comments
update README and bump version