From d736414896cb4f6643c6f2634f1ec74a2c500620 Mon Sep 17 00:00:00 2001
From: 266-750Balloons <79549730+266-750Balloons@users.noreply.github.com>
Date: Mon, 4 Nov 2024 10:16:28 -0700
Subject: [PATCH] docs: add render glitch workwaround (#1699)

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

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 23ba479..4ea9be8 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -4,6 +4,7 @@
 
 - [Linux](#linux)
   - [Fonts showing up as rectangles](#linux-fonts-rectangle)
+  - [Text and/or the entire interface not appearing](#linux-rendering-glitches)
   - [Global menu workaround for KDE](#linux-kde-global-menu)
   - [Flatpak most common issues](#linux-flatpak-most-common-issues)
   - [Remote SSH doesn't work](#linux-remote-ssh)
@@ -24,6 +25,14 @@ rm -rf ~/snap/codium/common/.cache
 fc-cache -r
 ```
 
+#### <a id="linux-rendering-glitches"></a>*Text and/or the entire interface not appearing*
+
+You have likely encountered [a bug in Chromium and Electron](microsoft/vscode#190437) when compiling Mesa shaders, which has affected all Visual Studio Code and VSCodium versions for Linux distributions since 1.82.  The current workaround (see microsoft/vscode#190437) is to delete the GPU cache as follows:
+
+```bash
+rm -rf ~/.config/VSCodium/GPUCache
+```
+
 #### <a id="linux-kde-global-menu"></a>*Global menu workaround for KDE*
 
 Install these packages on Fedora: