add docs for some methods