adjust parameters, add documentation