wrote some notes about upcoming changes