more documentation
fixing issues with the cli refactor