add defaults in docs
explicit doc