add docs to the new method