doc + new constructor for parameters object