update doc + verbosity