document new interface