Clarified and updated some method docs