add docs to new methods