CB-7345 improve cli documentation
CB-7345 add tests to validate documentation