document the 2 major changes