1 files changed, 32 insertions, 0 deletions
diff --git a/roles/packages/README.md b/roles/packages/README.md
new file mode 100644
index 0000000..af495cb
--- /dev/null
+++ b/roles/packages/README.md
@@ -0,0 +1,32 @@
+Packages
+========
+
+Description
+-----------
+
+The `packages` role installs a given set of packages.
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable           | Default  | Description
+-------------------|----------|------------
+`packages_install` | `[]`     | List of packages to install
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- hosts: all
+  roles:
+    - role: packages
+      vars:
+        packages_install:
+          - tmux
+          - less
+          - man
+````