From 4e1191312745597b2312fda3d53e079ace4ea7f3 Mon Sep 17 00:00:00 2001
From: Albert Y <76888457+filterpaper@users.noreply.github.com>
Date: Fri, 28 Oct 2022 10:03:16 +0800
Subject: [PATCH] feat(docs): troubleshooting steps for macOS 13 Finder bug

---
 docs/docs/troubleshooting.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md
index 46901d15..91c7d6d7 100644
--- a/docs/docs/troubleshooting.md
+++ b/docs/docs/troubleshooting.md
@@ -21,6 +21,10 @@ Variations of the warnings shown below occur when flashing the `<firmware>.uf2`
 | :--------------------------------------------------------------------------: |
 |                An example of the file transfer error on MacOS                |
 
+### MacOS Ventura error
+
+MacOS 13.0 (Ventura) Finder running on Apple silicon hardware may report an error code 100093 when copying `<firmware>.uf2` files into microcontrollers. This bug is limited to the operating system's Finder. You can work around it by copying on Terminal command line or use a third party file manager.
+
 ### CMake Error
 
 An error along the lines of `CMake Error at (zmk directory)/zephyr/cmake/generic_toolchain.cmake:64 (include): include could not find load file:` during firmware compilation indicates that the Zephyr Environment Variables are not properly defined.