From 4fb3792125b7257ba7b14c6abcc5cb3e41353d5b Mon Sep 17 00:00:00 2001
From: Anthony Berg <smyalygames@gmail.com>
Date: Mon, 26 Jun 2023 16:23:56 +0100
Subject: [PATCH] feat(docs): add troubleshooting for accessibility settings

---
 src/pages/msfs/_meta.json          |  1 +
 src/pages/msfs/troubleshooting.mdx | 24 ++++++++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 src/pages/msfs/troubleshooting.mdx

diff --git a/src/pages/msfs/_meta.json b/src/pages/msfs/_meta.json
index d2efb95..3e38128 100644
--- a/src/pages/msfs/_meta.json
+++ b/src/pages/msfs/_meta.json
@@ -1,4 +1,5 @@
 {
   "index": "Introduction",
+  "troubleshooting": "Troubleshooting",
   "utils": "Utilities"
 }
diff --git a/src/pages/msfs/troubleshooting.mdx b/src/pages/msfs/troubleshooting.mdx
new file mode 100644
index 0000000..af12aba
--- /dev/null
+++ b/src/pages/msfs/troubleshooting.mdx
@@ -0,0 +1,24 @@
+# Troubleshooting
+
+This page is for general troubleshooting tips for Flight Simulator only, not for addon troubleshooting.
+
+## Freezing on Accessibility Settings in the Loading Screen
+
+The most likely reason for this freeze is due to the screen reader being enabled on this menu and as there is no
+screen reader provided on Linux, this will result in Flight Simulator freezing.
+
+To fix this issue, you will have to remove the screen reader config in the Flight Simulator directory, inside
+`steamapps`.
+
+The file that causes this problem is:
+
+```
+MicrosoftFlightSimulator/Packages/fs-base-ui/ScreenReader/ScreenReader.xml
+```
+
+And you can rename it to remove this file. You can use the command below (**change directories to point to your
+`steamapps` if Flight Simulator is not installed in the default location**)
+
+```shell copy
+mv ~/.steam/steam/steamapps/common/MicrosoftFlightSimulator/Packages/fs-base-ui/ScreenReader/ScreenReader.xml ~/.steam/steam/steamapps/common/MicrosoftFlightSimulator/Packages/fs-base-ui/ScreenReader/ScreenReader.xml.bak
+```