diff --git a/.github/workflows/documentation.yaml b/.github/workflows/documentation.yaml
new file mode 100644
index 0000000..ea08a26
--- /dev/null
+++ b/.github/workflows/documentation.yaml
@@ -0,0 +1,22 @@
+name: Generate terraform READme
+on:
+  push:
+    branches:
+      - main
+jobs:
+  docs:
+    permissions: write-all
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Generate TF Docs
+        uses: terraform-docs/gh-actions@v1.0.0
+        with:
+          working-dir: .
+          output-file: README.md
+          output-method: inject
+          git-push: "true"