From d993b0343304c1d7f67837e1d5a42e70bf05a8f2 Mon Sep 17 00:00:00 2001
From: Cem Aksoylar <caksoylar@gmail.com>
Date: Fri, 12 Aug 2022 14:53:55 -0700
Subject: [PATCH] feat(docs): Refer to troubleshooting in connecting split
 halves

---
 docs/docs/user-setup.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/docs/user-setup.md b/docs/docs/user-setup.md
index 961d1079..a2e491b8 100644
--- a/docs/docs/user-setup.md
+++ b/docs/docs/user-setup.md
@@ -213,3 +213,11 @@ ZMK supports multiple BLE “profiles”, which allows you to connect to and swi
 ### Connecting Split Keyboard Halves
 
 For split keyboards, after flashing each half individually you can connect them together by resetting them at the same time. Within a few seconds of resetting, both halves should automatically connect to each other.
+
+:::note
+
+If you have issues connecting the halves, make sure that both sides are getting powered properly through USB or batteries, then follow the
+[recommended troubleshooting procedure](troubleshooting.md#split-keyboard-halves-unable-to-pair). This is typically necessary if you
+swapped firmware sides between controllers, like flashing left side firmware to the same controller after flashing the right, or vice versa.
+
+:::