✨ Enhance module documentation with detailed descriptions for DNS, Foundry, Pangolin, and Public IP modules

modules/dns/main.tf

@@ -1,3 +1,11 @@
+/**
+ * # DNS Module
+ *
+ * Manages Cloudflare DNS records for the root domain:
+ * - A / AAAA records for the apex and wildcard pointing at the Pangolin proxy.
+ * - CDN-proxied A / AAAA records for selected subdomains.
+ */
+
 terraform {
   required_providers {
     cloudflare = {

modules/dns/variables.tf

@@ -1,17 +1,21 @@
 variable "domain_zone_id" {
-  type = string
+  description = "Cloudflare Zone ID for the target domain."
+  type        = string
 }
 
 variable "domain_name" {
-  type = string
+  description = "Root domain name (e.g. 'example.com')."
+  type        = string
 }
 
 variable "pangolin-proxy-v4" {
-  type = string
+  description = "IPv4 address of the Pangolin reverse-proxy."
+  type        = string
 }
 
 variable "pangolin-proxy-v6" {
-  type = string
+  description = "IPv6 address of the Pangolin reverse-proxy."
+  type        = string
 }
 
 variable "cdn_subdomains" {