docs: document the openItem -> openPath breaking change (electron#22507)

MarshallOfSound · erickzhao · web-flow · commit 986ccfa816e5 · 2020-03-03T23:17:27.000-08:00
* docs: document the openItem -&gt; openPath breaking change

* Apply suggestions from code review

Co-Authored-By: Erick Zhao &lt;erick@hotmail.ca&gt;

Co-authored-by: Erick Zhao &lt;erick@hotmail.ca&gt;
diff --git a/docs/breaking-changes.md b/docs/breaking-changes.md
@@ -84,6 +84,11 @@ In Electron 9.0, the old serialization algorithm has been removed, and sending
 such non-serializable objects will now throw an "object could not be cloned"
 error.
 
+### `shell.openItem` --> `shell.openPath`
+
+The `shell.openItem` API has been replaced with an asynchronous `shell.openPath` API.
+You can see the original API proposal and reasoning [here](https://github.com/electron/governance/blob/master/wg-api/spec-documents/shell-openitem.md).
+
 ## Planned Breaking API Changes (8.0)
 
 ### Values sent over IPC are now serialized with Structured Clone Algorithm
