documentation and default params
adds 2 minor gaps
mode documentation