document some changes