added docs for new methods