From 7407a39bbb9afb3d56871aafd221ca88e8c3d085 Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Mon, 17 Jul 2023 17:26:39 -0500
Subject: [PATCH] migration instructions

---
 docs/migration.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/migration.md

diff --git a/docs/migration.md b/docs/migration.md
new file mode 100644
index 0000000..4ce5886
--- /dev/null
+++ b/docs/migration.md
@@ -0,0 +1,14 @@
+# Migration
+
+Migration instructions for devices from deCONZ to Zigbee2MQTT
+
+## Process
+
+1. Delete device in deCONZ
+2. Reload the deCONZ integration
+3. Fire the `deconz.remove_orphaned_entities` service
+4. Restart Home Assistant platform. Restarting the whole system isn't necessary.
+5. Factory reset device (varies per device)
+6. Pair with Zigbeet2MQTT
+7. Rename device and apply to Home Assistant
+8. Rename entity in AppDaemon
\ No newline at end of file