From 634f4950f052619409d134ad7a33a7998a4b1a51 Mon Sep 17 00:00:00 2001
From: Daniel Fainberg <mail@daniel.fainberg.net>
Date: Mon, 29 Jun 2026 11:27:50 +0200
Subject: [PATCH] Add README

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b732fae
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# dotfiles
+
+Designed around [GNU stow][gnu stow manual].
+For `zsh` or `bash` (or both). Include `shell/` always.
+
+## Install
+
+```sh
+git clone <repo> ~/.dotfiles
+cd ~/.dotfiles
+stow shell zsh # or: stow shell bash
+```
+
+## Update
+
+```sh
+cd ~/.dotfiles
+git pull
+stow -R shell zsh # restow this host's packages
+```
+
+[gnu stow manual]: https://www.gnu.org/software/stow/manual/stow.html
+