Adding in some documentation to ensure files are updated as needed

Also pulls forward the comments added in 9a3d92f7
to nyc-mr2-dev

Bug: 33090697
Bug: 32608129
Test: None (comment only change)
Change-Id: Ic23d099767ad4c711bf2d3586cdefd626dec1ce0