1 files changed, 32 insertions, 0 deletions
diff --git a/roles/timezone/README.md b/roles/timezone/README.md
new file mode 100644
index 0000000..d04b473
--- /dev/null
+++ b/roles/timezone/README.md
@@ -0,0 +1,32 @@
+Timezone
+========
+
+Description
+-----------
+
+The `timezone` role sets the system timezone, and ensures the system clock
+uses UTC.
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable   | Default   | Description
+-----------|-----------|------------
+`timezone` | `Etc/UTC` | System timezone
+
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: set timezone
+  hosts: all
+  roles:
+    - role: timezone
+      vars:
+        timezone: America/New_York
+````