make doc string and parameter list less cryptic