documentation and verbosity changes