From 575c48b16332179191add3eb44142a79db9b0d22 Mon Sep 17 00:00:00 2001
From: Aaron Randreth <90899181+aaron-randreth@users.noreply.github.com>
Date: Fri, 25 Oct 2024 00:48:14 +0200
Subject: [PATCH] binds: Improve docs for workspace key binds on non-qwerty
 keyboards. (#824)

Explain why the defaults for the workspaces do not work on a french azerty keyboard, and how to fix it.

Fixes  #810
---
 pages/Configuring/Binds.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/pages/Configuring/Binds.md b/pages/Configuring/Binds.md
index 972cecf..3e34e1f 100644
--- a/pages/Configuring/Binds.md
+++ b/pages/Configuring/Binds.md
@@ -53,6 +53,26 @@ can also use `xev` or `wev` to find keycodes.
 
 ## Misc
 
+### Workspace bindings on non-qwerty layouts 
+
+Keys used for keybinds need to be accessible without any modifiers in your layout. For instance, the `French Azerty` layout uses `SHIFT+unmodified_key` to write `0-9` numbers. As such, the workspace keybinds for this layout need to use the names of the `unmodified_key`s, and will not work when using the `0-9` numbers.
+
+{{< callout type=info >}}
+
+To get the correct name for an `unmodified_key`, refer to [the section on uncommon syms](#uncommon-syms--binding-with-a-keycode)
+
+{{< /callout >}}
+
+```ini
+# On a french layout, instead of
+# bind = $mainMod, 1, workspace,  1
+
+# Use 
+bind = $mainMod, ampersand, workspace,  1
+```
+
+For help configuring the `French Azerty` layout, [see](https://rherault.dev/articles/hyprland-fr-layout).
+
 ### Unbind
 
 You can also unbind with `unbind`, e.g.: