Document changes from #7968 in Upgrading Guide

It would be nice to have this in the Upgrading Guide since it's a breaking change.

/cc  @rafaelfranca, @stevenharman

#7968, #9294