docs: подробные комментарии в примерах DNS-зон и записей

dns_zones_generated/variables.tf

@@ -1,29 +1,40 @@
-# Переменные примера. api_token — СЕКРЕТ, держать в secrets.auto.tfvars.
+# =============================================================================
+# Переменные примера «N DNS-зон, сгенерированных программно».
+#
+# ⚠️ api_token — СЕКРЕТ: не в terraform.tfvars, а в secrets.auto.tfvars
+#    (Terraform подхватывает `*.auto.tfvars` сам), файл — в .gitignore.
+# =============================================================================
 
+# Токен доступа (JWT) к API Nubes. `sensitive` — не показывать значение в выводе.
 variable "api_token" {
   description = "Nubes API token (JWT). Секрет — в secrets.auto.tfvars."
   type        = string
   sensitive   = true
 }
 
+# Адрес API Gateway стенда (для TEST — как в default).
 variable "api_endpoint" {
   description = "API Gateway URL стенда"
   type        = string
   default     = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
 }
 
+# ── Параметры генерации зон ──────────────────────────────────────────────────
+# Сколько однотипных зон создать: tfzone-1 … tfzone-<zone_count>.
 variable "zone_count" {
   description = "Сколько зон сгенерировать (tfzone-1 … tfzone-N)"
   type        = number
   default     = 10
 }
 
+# Префикс имени/домена зоны (первая часть FQDN).
 variable "zone_prefix" {
   description = "Префикс имени зоны"
   type        = string
   default     = "tfzone"
 }
 
+# Домен (суффикс FQDN). Итоговое имя зоны = "<prefix>-<i>.<zone_domain>".
 variable "zone_domain" {
   description = "Домен зон (суффикс FQDN)"
   type        = string