document some additional important changes