document remote_file breaking change

I tried to build the docs and verify that the tags linked correctly but I couldn't find the html version of the file I built. Anyway, the text itself is good so it should be enough to make the change on your own if I did something that doesn't work.