update docs and add parameters to method documentation