diff --git a/.terraform-docs.yml b/.terraform-docs.yml
new file mode 100644
index 0000000..227afcc
--- /dev/null
+++ b/.terraform-docs.yml
@@ -0,0 +1,46 @@
+## https://github.com/antonbabenko/pre-commit-terraform/issues/248#issuecomment-1290829226
+formatter: "markdown table"
+
+header-from: main.tf
+footer-from: ""
+
+sections:
+##  hide: []
+  show: 
+    - data-sources
+    - header
+    - footer
+    - inputs
+    - modules
+    - outputs
+    - providers
+    - requirements
+    - resources
+    
+output:
+  file: README.md
+  mode: inject
+  template: |-
+    <!-- BEGIN_TF_DOCS -->
+    {{ .Content }}
+    <!-- END_TF_DOCS -->
+
+## output-values:
+##   enabled: false
+##   from: ""
+## 
+## sort:
+##   enabled: true
+##   by: name
+## 
+## settings:
+##   anchor: true
+##   color: true
+##   default: true
+##   description: false
+##   escape: true
+##   indent: 2
+##   required: true
+##   sensitive: true
+##   type: true
+