annotated code for planned changes