documentation and default for debug mode