diff --git a/roles/ansible-pull/README.md b/roles/ansible-pull/README.md
new file mode 100644
index 0000000..e87967d
--- /dev/null
+++ b/roles/ansible-pull/README.md
@@ -0,0 +1,3 @@
+# ansible-pull
+
+This role configures and enables a period `ansible-pull` task through systemd, allowing for machines to ensure proper configuration periodically and of their own volition.
diff --git a/roles/common/README.md b/roles/common/README.md
new file mode 100644
index 0000000..26cf165
--- /dev/null
+++ b/roles/common/README.md
@@ -0,0 +1,5 @@
+# common
+
+This role configures common machine configuration, such as ensuring the correct hostname/timezone and installing basic administration packages.
+
+Additionally, it ensures that the user `ansible` is configured properly.