From f48d68da9d603bfe51aac13b3f154f779a1dc9be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20D=C3=A9siles?=
 <1536672+cdesiles@users.noreply.github.com>
Date: Fri, 3 Jul 2026 00:11:52 +0200
Subject: [PATCH] doc: add readme to zsh

---
 roles/zsh/README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 roles/zsh/README.md

diff --git a/roles/zsh/README.md b/roles/zsh/README.md
new file mode 100644
index 0000000..7027d69
--- /dev/null
+++ b/roles/zsh/README.md
@@ -0,0 +1,31 @@
+# zsh configuration
+
+## Features
+
+- **Powerlevel10k** theme with instant prompt
+- **Syntax highlighting** for commands
+- **Autosuggestions** based on history
+- **fzf integration** (Ctrl+R history, Ctrl+T files, Alt+C directories)
+- **fzf-tab** for completion menus
+- **Smart aliases** (docker → podman)
+- **Persistent history** across sessions
+
+## Configuration
+
+### Users
+
+Configure users in inventory:
+
+```yaml
+zsh_users:
+  - jsmith
+  - root
+```
+
+## Keybindings
+
+- `↑/↓` - History search with substring matching
+- `Ctrl+R` - Fuzzy history search
+- `Ctrl+T` - Fuzzy file search
+- `Alt+C` - Fuzzy directory change
+- `Tab` - fzf completion menu