diff --git a/README.md b/README.md
index d23d95a..cd4aa82 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
-# dotfiles
+# dotfiles **(WIP)**
+This repository contains my dotfiles. They are managed by using `git clone --bare`,
+see for example [How to Store Dotfiles - A Bare Git Repository \| Atlassian Git Tutorial](https://www.atlassian.com/git/tutorials/dotfiles).
 
+## On a new machine
+1. install git
+1. `cd ~`
+1. `git clone --bare --depth 1 --recurse-submodules --shallow-submodules git@jaandrle.cz:jaandrle/dotfiles.git ~/.dotfiles`
+1. `alias git-dotfiles='/usr/bin/git --git-dir="$HOME/.dotfiles/" --work-tree="$HOME"'`
+1. `git-dotfiles config --local status.showUntrackedFiles no`
+1. you may also need to use
+	1. `git-dotfiles reset` (`git-dotfiles reset --hard HEAD`)
+	1. `git-dotfiles checkout -f`
+	1. `git-dotfiles submodule update --init --recursive`