From e4aa83dbd67988bb8489ac6e087b97b4264a8164 Mon Sep 17 00:00:00 2001
From: Cem Aksoylar <caksoylar@users.noreply.github.com>
Date: Tue, 8 Oct 2024 15:05:35 -0700
Subject: [PATCH] docs: Remove download for settings_reset and note local build

---
 .../splitpairing/corecoverage.png             | Bin 3420 -> 0 bytes
 .../troubleshooting/connection-issues.mdx     |  45 +++---------------
 2 files changed, 6 insertions(+), 39 deletions(-)
 delete mode 100755 docs/docs/assets/troubleshooting/splitpairing/corecoverage.png

diff --git a/docs/docs/assets/troubleshooting/splitpairing/corecoverage.png b/docs/docs/assets/troubleshooting/splitpairing/corecoverage.png
deleted file mode 100755
index a2a928be1f8e57c6feabd8b5058aa3b1130b35c6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3420
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
P5dq+ONLZbYeawFWzejJp

diff --git a/docs/docs/troubleshooting/connection-issues.mdx b/docs/docs/troubleshooting/connection-issues.mdx
index 7de953a96cad..d2e9620725a7 100644
--- a/docs/docs/troubleshooting/connection-issues.mdx
+++ b/docs/docs/troubleshooting/connection-issues.mdx
@@ -4,24 +4,6 @@ sidebar_label: Connection Issues
 description: Troubleshooting wireless connection issues of ZMK devices.
 ---
 
-import Tabs from "@theme/Tabs";
-import TabItem from "@theme/TabItem";
-
-export const Uf2Tabs = (props) => (
-    <Tabs
-    groupId="operating-system"
-    defaultValue="build"
-    values={[
-      { label: "Build using 'zmk-config'", value: "build" },
-      { label: "Download from ZMK Workflow", value: "download" },
-    ]}
-  >
-    {/* eslint-disable-next-line */}
-    {props.children}
-  </Tabs>
-
-);
-
 :::tip
 [USB logging](../development/usb-logging.mdx) can be very helpful for diagnosing issues with ZMK. However, when connected to USB your ZMK device will output to USB by default. To troubleshoot wireless connection issues using logging, you will need to [change the preferred output endpoint](../keymaps/behaviors/outputs.md).
 :::
@@ -41,14 +23,9 @@ This procedure will erase all settings, such as Bluetooth profiles, output selec
 
 :::
 
-### Acquiring a Reset UF2
-
-First, acquire the reset UF2 image file with one of the following options:
+### Building a Reset UF2
 
-<Uf2Tabs>
-<TabItem value="build">
-
-Find the `build.yaml` file in your `zmk-config` folder and add an additional settings reset build for the board used by your split keyboard. For example assuming that the config repo is setup for nice!nano v2 with Corne, append the `settings_reset` shield to the `build.yaml` file as follows:
+If you are using GitHub Actions to build your firmware as described in the [user setup](../user-setup.mdx), find the `build.yaml` file in your `zmk-config` folder and add an additional settings reset build for the board used by your split keyboard. For example assuming that the config repo is setup for nice!nano v2 with Corne, append the `settings_reset` shield to the `build.yaml` file as follows:
 
 ```yml
 include:
@@ -60,28 +37,18 @@ include:
     shield: settings_reset
 ```
 
-Save the file, commit the changes and push them to GitHub. Download the new firmware zip file build by the latest GitHub Actions job. In it you will find an additional `settings_reset` UF2 image file.
+If you are building for an onboard controller keyboard that doesn't use a shield, you can add a new `shield:` field with its `board:` entry.
 
-</TabItem>
-
-<TabItem value="download">
-1. [Open the `Build` workflow](https://github.com/zmkfirmware/zmk/actions/workflows/build.yml?query=event%3Apush+branch%3Amain+is%3Asuccess) from the `Actions` tab of the ZMK GitHub repository.
-1. Find one of the results for which the `core-coverage` job ran successfully, indicated by a green checkmark in the "core-coverage" bubble like the image example below.
-1. From the next page under "Artifacts", download and unzip the `<board_name>-settings_reset-zmk` zip file for the UF2 image.
-
-| ![Successful core-coverage Job](../../docs/assets/troubleshooting/splitpairing/corecoverage.png) |
-| :----------------------------------------------------------------------------------------------: |
-|    An example of a successful core-coverage job which will produce a settings_reset firmware.    |
+Save the file, commit the changes and push them to GitHub. Download the new firmware zip file build by the latest GitHub Actions job. In it you will find an additional `settings_reset` UF2 image file.
 
-</TabItem>
-</Uf2Tabs>
+If you use a [local development environment](../development/local-toolchain/setup/index.md) to build firmware instead of GitHub Actions, you can replace your `-DSHIELD=` argument value with `settings_reset` in the [build command](../development/local-toolchain/build-flash.mdx), or add one if the keyboard doesn't normally use one.
 
 ### Reset Split Keyboard Procedure
 
 Perform the following steps to reset **_both_** halves of your split keyboard:
 
 1. Put each half of the split keyboard into bootloader mode.
-1. Flash one of the halves of the split with the downloaded settings reset UF2 image.
+1. Flash one of the halves of the split with the settings reset UF2 image.
 1. Repeat step 2 with the other half of the split keyboard.
 1. Flash the actual image for each half of the split keyboard (e.g `my_board_left.uf2` to the left half, `my_board_right.uf2` to the right half).