be generous with default parameters
add code to README