Refactor to modular structure

.github/scripts/generate-docs.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Determine repo root path relative to this script
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+# Path to terraform-docs config
+TFDOCS_CONFIG="${REPO_ROOT}/.terraform-docs.yml"
+
+# Check terraform-docs is installed
+if ! command -v terraform-docs &> /dev/null; then
+  echo "❌ terraform-docs is not installed. Install it from https://terraform-docs.io/"
+  exit 1
+fi
+
+echo "📘 Generating module documentation using config at: $TFDOCS_CONFIG"
+echo
+
+# Loop through all submodules with a variables.tf file
+find "${REPO_ROOT}/modules" -type f -name "variables.tf" | while read -r tf_file; do
+  MODULE_DIR="$(dirname "$tf_file")"
+  echo "📄 Updating docs for module: ${MODULE_DIR#$REPO_ROOT/}"
+
+  terraform-docs --config "$TFDOCS_CONFIG" "$MODULE_DIR" > "$MODULE_DIR/README.md"
+done
+
+echo
+echo "✅ Documentation generated for all modules."

.terraform-docs.yml

@@ -1,12 +1,12 @@
 formatter: markdown
 
-header-from: "docs/header.md"
-footer-from: "docs/footer.md"
-
-output:
-  file: README.md
-  mode: inject
-
-sort:
-  enabled: true
-  by: name
+output-file: README.md
+output-mode: inject
+sections:
+  show-header: true
+  show-inputs: true
+  show-outputs: true
+  show-providers: false
+  show-requirements: false
+  show-resources: false
+  show-data-sources: false

CONTRIBUTING.md

@@ -27,7 +27,7 @@ Pull requests are the best way to propose changes to the codebase. We actively w
 This module uses [terraform-docs](https://terraform-docs.io/user-guide/introduction/) to generate documentation. To generate the documentation, run the following command from the root of the repository:
 
 ```bash
-terraform-docs --config .terraform-docs.yml .
+.github/scripts/generate-docs.sh
 ```
 
 ## Development Process