added docs to the methods