document new descriptions