add documentation to new params