[all] improve output and docs