some tweaks to the command ui output as well as some documentation and tests