+1 added doc for methods