updated docs with additional params