diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
new file mode 100644
index 0000000..6583082
--- /dev/null
+++ b/.gitlab-ci.yml
@@ -0,0 +1,9 @@
+---
+
+stages:
+  - check
+
+Check config:
+  stage: check
+  scripts:
+    i3 -C config
diff --git a/README.md b/README.md
index 2ca3d04..cd2b307 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,12 @@
 # i3
-i3 configuration
+
+Basic i3 configuration
+* scripts in bin/
+* temporary files in run/ (should not be pushed)
+* env file for various specific variables:
+
+```
+PRIMARY_OUTPUT=HDMI-1
+SECONDARY_OUTPUT=HDMI-2
+SECONDARY_OUTPUT_POSITION=--left-of
+```