added docs to methods