improve options doc formatting
add doc on how to use external reporter
bump deps