add some more docs to methods