added doc to new method