update documentation, rename parameters/methods