diff --git a/Design:-Editor-Events.md b/Design:-Editor-Events.md
new file mode 100644
index 0000000..f755561
--- /dev/null
+++ b/Design:-Editor-Events.md
@@ -0,0 +1,10 @@
+The follow components emit events for the internal workings of the editor. Need to decide if it makes sense to expose these directly as part of the API, or hide them behind a single `RED.events` component.
+
+| Component | Event | Args | Description |
+|-----------|-------|------|-------------|
+|`RED.nodes` | `change` | `{ dirty: true/false }` | The 'dirty' state of the flow has changed.|
+|`RED.sidebar` | `resize` | | The sidebar has changed size.|
+|`RED.view` | `selection-changed` | `{ nodes: [], link: link }` | The node selection has changed. |
+|`RED.workspaces` | `change` | `{ old: 'tab-id', workspace: 'tab-id' }` | The visible workspace tab has changed |
+
+