summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/user-configuration.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/user-configuration.md b/doc/user-configuration.md
index b8c4d30..2146599 100644
--- a/doc/user-configuration.md
+++ b/doc/user-configuration.md
@@ -31,6 +31,15 @@ Each directory should have one or more of the following subdirectories:
- `symbols`
- `types`
+The majority of user-specific configuration involve modifying key symbols and
+this is what this document focuses on. For use-cases where a user may need to
+add new key types or compat entries the general approach remains the same. A
+detailed description for how to add those types or compat entries is out of
+scope for this document.
+
+You should never need to add user-specific keycodes. Where a keycode is missing,
+the addition should be filed in the upstream xkeyboard-config project.
+
## RMLVO vs KcCGST
Due to how XKB is configured, there is no such thing as a "layout" in XKB