document new methods