added doc for new methods