[VOL-4423] VOLTHA API deprecation policy
Change-Id: I29555eb4361b62952409659eced9a12449c42d75
diff --git a/release_notes/release_process.rst b/release_notes/release_process.rst
index 827008d..90ccc97 100644
--- a/release_notes/release_process.rst
+++ b/release_notes/release_process.rst
@@ -110,9 +110,22 @@
- Robot tests for integration-related issues
- Unit tests for code-level issues
+API Deprecation policy
+----------------------
-Repos branched for each release
--------------------------------
+VOLTHA has in place a 2 release deprecation policy. Starting from ``voltha-2.9`` the APIs that are marked as deprecated
+are automatically removed after 2 releases.
+As an example an API marked as deprecated in ``voltha-2.9`` will be removed after the ``voltha-2.10`` release
+and will not be present anymore in ``voltha-2.11``.
+
+The removal process is intended to happen automatically, meaning no further notice of removal needs to be sent out.
+The deprecated objects and APIs are marked in the `voltha-protos <https://github.com/opencord/voltha-protos>`_ using the
+``deprecated`` construct from protobuf, as per `specification <https://developers.google.com/protocol-buffers/docs/proto3>`_.
+An example is ``int32 old_field = 6 [deprecated = true];``
+
+
+Repos (lazily) branched for each release
+----------------------------------------
Charts
""""""
@@ -123,6 +136,7 @@
"""""""
- voltha-system-tests
+- pod-configs
Tools
"""""
@@ -135,16 +149,16 @@
- aaa
- dhcpl2relay
-- igmp
+- igmpproxy
- kafka
- mcast
- olt
- sadis
+- mac-learning
Libraries
"""""""""
-- pyvoltha
- voltha-lib-go
- voltha-protos