FLUID-5379: Add API changes and deprecations to readme

@jobara, I think this is the last task for FLUID-5379