From ddf95a9866091208358b7f6b20d76cef5b061fc5 Mon Sep 17 00:00:00 2001
From: Maciej Sobkowski <maciej@sobkow.ski>
Date: Sun, 6 Apr 2025 20:50:51 +0200
Subject: README.md: expand README

---
 README.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1a846be..3326ace 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
-# dotfiles
+# dotfiles v2
 
-Config files for software I use.
+Fresh attempt at organizing config files for software I use.
+
+## Organization
+
+I used to use GNU Stow for symlinking dotfiles for me, now trying out a different approach.
+This is essentially my $HOME dir tracked in a git repository. To set up on a new machine it should be enough to clone this repository and add machine-specific configuration for Sway etc.
+
+## Supported machines
+
+I currently maintain the configuration for the following machines, all running Arch Linux:
+
+- `speedwagon` - personal laptop (ThinkPad T14 Gen2)
+- `grandmaster4000` - work PC
+- `fireball` - my VPS
-- 
cgit v1.2.3-70-g09d2