minor changes to docs and methods