diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..8fade0a
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,16 @@
+= Dotfiles managed with chezmoi
+
+See https://github.com/twpayne/chezmoi
+
+== Initialization
+
+TODO: how to handle a new linux system correctly.
+
+Test with `centos7-01`:
+
+. put executable to HOME dir
+. initialize with `./chezmoi init https://gitea.sdroid.uber.space/heavy/dotfiles.git`
+. check what will happen with `./chezmoi diff`
+. apply it with `./chezmoi apply`
+
+After that a `bin` directory will exist (if not yet present before), move the executable to this dir to have it `PATH`.