Document properly which params are optional and its default values