From a4703537603d1ae7f5a904fc57d61af7382b6f9f Mon Sep 17 00:00:00 2001
From: Nick Winans <nick@winans.codes>
Date: Mon, 4 Jan 2021 12:42:22 -0600
Subject: [PATCH] docs(shield): Add docs based on #510 changes

---
 docs/docs/development/new-shield.md | 34 ++++++++++++++---------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/docs/docs/development/new-shield.md b/docs/docs/development/new-shield.md
index acc636fd..ceb81d10 100644
--- a/docs/docs/development/new-shield.md
+++ b/docs/docs/development/new-shield.md
@@ -91,6 +91,9 @@ endif
 ```
 
 Similarly to defining the halves of a split board in `Kconfig.shield` it is important to set the `ZMK_KEYBOARD_NAME` for each half of a split keyboard.
+You'll also want to set which half is the central side. Most boards set it to the left.
+Then on the peripheral half, you'll want to turn USB on so that it shows USB status on displays properly.
+Finally, you'll want to turn on the split option for both sides. This can all be seen below.
 
 ```
 if SHIELD_MY_BOARD_LEFT
@@ -98,6 +101,9 @@ if SHIELD_MY_BOARD_LEFT
 config ZMK_KEYBOARD_NAME
 	default "My Awesome Keyboard Left"
 
+config ZMK_SPLIT_BLE_ROLE_CENTRAL
+	default y
+
 endif
 
 if SHIELD_MY_BOARD_RIGHT
@@ -105,6 +111,16 @@ if SHIELD_MY_BOARD_RIGHT
 config ZMK_KEYBOARD_NAME
 	default "My Awesome Keyboard Right"
 
+config USB
+	default y
+
+endif
+
+if SHIELD_MY_BOARD_LEFT || SHIELD_MY_BOARD_RIGHT
+
+config ZMK_SPLIT
+	default y
+
 endif
 ```
 
@@ -265,23 +281,7 @@ For example, a split board called `my_awesome_split_board` would have the follow
 - `my_awesome_split_board_left.conf` - Configuration elements only affect left half
 - `my_awesome_split_board_right.conf` - Configuration elements only affect right half
 
-For proper communication between keyboard halves and that between the central half and the computer,
-the **the central and peripheral halves of the keyboard must be defined**. This can be seen below.
-
-```
-// Central Half (Usually the left side: my_awesome_split_board_left.conf)
-
-CONFIG_ZMK_SPLIT=y
-CONFIG_ZMK_SPLIT_BLE_ROLE_CENTRAL=y
-```
-
-```
-// Peripheral Half (Usually the right side: my_awesome_split_board_right.conf)
-
-CONFIG_ZMK_SPLIT=y
-```
-
-Using the .conf file that affects both halves of a split board would be for adding features like deep-sleep or rotary encoders.
+In most case you'll only need to use the .conf file that affects both halves of a split board. It's used for adding features like deep-sleep or rotary encoders.
 
 ```
 // my_awesome_split_board.conf