diff --git a/README.md b/README.md
index a5e51c6..78c823b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
-ansible_linux_setup
+# ansible_linux_setup
+
+## Linux server setup
+
+### `provision.yml`
+
+- Set `hosts` to `all`
+- Set `target_system` to `linux`
+
+## Mac setup
+
+### `provision.yml`
+
+- Set `hosts` to `127.0.0.1`
+- Set `connection` to `local`
+- Set `default_user` to Mac user
+- Set `default_user_group` to Mac user's group
+- Set `ansible_become_pass` to users password for sudo