a few updates to docs and adding parameters