IMHO a .txt migration guide is not the proper place to do that, specially since the comment is pretty clear and straight forward