X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=RELEASE.md;h=392bbb6f839e8f20588f5a7eac9f327c678df444;hb=78053e164fbb75c014126a3deff440f165504582;hp=8bb5b705fe3c51e4f0bedaa5a98f4f2e7d6ce406;hpb=2e70d8b31d81269330700f94fcd5a9e401a7d7e9;p=vpp.git

diff --git a/RELEASE.md b/RELEASE.md
index 8bb5b705fe3..392bbb6f839 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -7,6 +7,26 @@
 
 @page release_notes_1704 Release notes for VPP 17.04
 
+## API changes
+
+- Python API: To avoid conflicts between VPP API messages names and
+  the Python API binding function names, VPP API methods are put in a
+  separate proxy object.
+  https://gerrit.fd.io/r/#/c/5570/
+  The api methods are now referenced as:
+    vpp_handle = VPP(jsonfiles)
+    vpp_handle.connect(...)
+    vpp = vpp_handle.api
+    vpp.show_version()
+    vpp_handle.disconnect()
+
+  For backwards compatibility VPP API methods are left in the main
+  name space (VPP), but will be removed from 17.07.
+
+- create_loopback message to be replaced with create_loopback_instance
+  create_loopback will be removed from 17.07.
+  https://gerrit.fd.io/r/#/c/5572/
+
 @todo Release 17.04 needs release notes.
 
 @page release_notes_1701 Release notes for VPP 17.01