Reorganize and update docs

troubleshooting.md

@@ -6,6 +6,7 @@ Then `sudo systemctl restart bluetooth`
 
 UPDATE: It's still not fixed :(
 Trying `yay -S pipewire wireplumber`
+TODO test it again
 
 # Touchpad scroll direction (libinput)
 
@@ -76,11 +77,11 @@ Synaptics scroll direction options:
 
 **Issue:** After running the theme switcher script, tmux sessions and existing terminals don't reflect the new theme until restarted.
 
-**Temporary workaround:** 
+**Temporary workaround:**
 - Restart tmux sessions: `tmux kill-server && tmux`
 - Open new terminal windows
 
-**TODO:** 
+**TODO:**
 - Investigate tmux theme reload without killing sessions
 - Check if terminal emulator supports theme change signals
 - Improve theme script to handle live theme updates
@@ -99,7 +100,7 @@ set -g @catppuccin_window_tabs_enabled off
 **Alternative:** Configure explicit window text for both states:
 ```
 set -g @catppuccin_window_default_text "#W"
-set -g @catppuccin_window_current_text "#W"  
+set -g @catppuccin_window_current_text "#W"
 ```
 
 Also ensure automatic renaming is enabled:
@@ -126,7 +127,7 @@ fc-cache -f
 
 **Root cause:** Terminal emulator not configured to use Nerd Font as primary font.
 
-**Solution:** 
+**Solution:**
 1. Install Nerd Fonts:
 ```bash
 sudo pacman -S ttf-iosevkaterm-nerd ttf-jetbrains-mono-nerd
@@ -137,8 +138,8 @@ fc-cache -f
 3. For wezterm, ensure config includes:
 ```lua
 config.font = wezterm.font_with_fallback {
-    'IosevkaTerm Nerd Font', 
-    'JetBrainsMono Nerd Font Mono', 
+    'IosevkaTerm Nerd Font',
+    'JetBrainsMono Nerd Font Mono',
     'Noto Color Emoji'
 }
 ```
@@ -152,8 +153,51 @@ printf "Icons: \\ue702 \\uf121 \\uf015 \\uf07b\\n"
 
 **Comprehensive coverage achieved with:**
 - `noto-fonts` (base unicode)
-- `noto-fonts-cjk` (Chinese/Japanese/Korean)  
+- `noto-fonts-cjk` (Chinese/Japanese/Korean)
 - `noto-fonts-emoji` (color emoji)
 - `noto-fonts-extra` (additional scripts)
 
 Successfully displays: Egyptian hieroglyphs, Cuneiform, Nordic runes, Hungarian rovás, Arabic, Chinese, Japanese, Korean, Thai, Hindi, Hebrew, Greek, Tamil.
+
+# Cannot tile windows by drag and dropping
+
+Keyboard workaround: Go to  Settings > Window Manager > Keyboard, set up tiling shortcuts (set to Super+arrow keys)
+
+# Additional Known Issues (TODO Items)
+
+## Tmux battery indicator missing until config reload
+
+**Issue:** Battery indicator doesn't appear in tmux status line immediately after starting tmux.
+
+**Temporary workaround:** Reload tmux config with `Prefix + r` or restart tmux session.
+
+**Status:** Investigation needed
+
+## TTY fallbacks needed
+
+**Issue:** When not in X11/graphical mode, nvim and tmux need proper fallback configurations.
+
+**Status:** Completed
+
+**Solutions implemented:**
+- ✅ **nvim:** TTY detection and color scheme fallback configured
+- ✅ **Font:** Selected ter-124b (12x24 bold) for good readability
+- ✅ **Keyboard:** Colemak layout with caps lock remapped to backspace
+- ✅ **Caps lock fix:** Uses systemd service with `setkeycodes 3a 14`
+
+**Configuration files:**
+- `/etc/systemd/system/caps-backspace.service` - Permanent caps lock remapping
+- TTY font testing script: `~/.local/scripts/test-fonts.sh`
+
+## TTY Caps Lock Not Working as Backspace
+
+**Issue:** With colemak keymap loaded, caps lock acts like Control instead of backspace in TTY.
+
+**Root cause:** Colemak keymap maps caps lock to Control, which conflicts with tmux navigation keys.
+
+**Solution:** Use `setkeycodes` to remap at scancode level:
+```bash
+sudo setkeycodes 3a 14  # Map caps lock scancode to backspace keycode
+```
+
+**Permanent fix:** Systemd service created at `/etc/systemd/system/caps-backspace.service`