document long CLI options
build updated documentation for dist
fix markup in markdown