Add breakages in public API of devref

In wiki it is intended to keep track of neutron changes that may affect
external plugins and drivers. The information should be kept in a living
document in the devref area of the neutron code tree.

Change-Id: Ic73ffd02fbaea48fcb6ad29dd5c9e91870064cb1
Closes-Bug: #1470598

doc/source/devref/neutron_api.rst

@@ -39,3 +39,28 @@ incompatible changes that could or are known to trigger those breakages.
   - commit: I933d02aa48260069149d16caed02b020296b943a
   - solution: switch using oslo_utils.fileutils module; stop using neutron.openstack.fileutils module.
   - severity: low (plugins must not rely on that subtree).
+
+* change: Reuse caller's session in DB methods.
+
+  - commit: 47dd65cf986d712e9c6ca5dcf4420dfc44900b66
+  - solution: Add context to args and reuse.
+  - severity: High (mostly undetected, because 3rd party CI run Tempest tests only).
+
+* change: switches to oslo.log, removes neutron.openstack.common.log.
+
+  - commit: 22328baf1f60719fcaa5b0fbd91c0a3158d09c31
+  - solution: a) switch to oslo.log; b) copy log module into your tree and use it
+    (may not work due to conflicts between the module and oslo.log configuration options).
+  - severity: High (most CI systems are affected).
+
+* change: Implements reorganize-unit-test-tree spec.
+
+  - commit: 1105782e3914f601b8f4be64939816b1afe8fb54
+  - solution: Code affected need to update existing unit tests to reflect new locations.
+  - severity: High (mostly undetected, because 3rd party CI run Tempest tests only).
+
+* change: drop linux/ovs_lib compat layer.
+
+  - commit: 3bbf473b49457c4afbfc23fd9f59be8aa08a257d
+  - solution: switch to using neutron/agent/common/ovs_lib.py.
+  - severity: High (most CI systems are affected).