README.md: expand README

1 files 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