adjust CLI args
fix ref to example bin
fix warning section
add lots of comments for YARD docs; wip
ignore doc (generated by YARD)
Document all the things!