docs: add detailed package-level comments to all TOOLS/ and provider/

TOOLS:
- yaml-generator: types (API↔YAML), client (proxy/REST + retry)
- resource-generator: types (3 resource kinds), loader (pipeline),
  writers (generated files), params (merge/CreateOnly/ForceNew)
- docs-generator, ops-generator — already documented

provider:
- main.go: entrypoint + build instructions
- core: API client (GetInstance, RunOperation, GetInstanceState)
- provider: provider registration (New, Resources, Schema)
- resources_core: shared CRUD, state refresh, params, validation

TOOLS/resource-generator/internal/writers/writers.go

@@ -1,4 +1,12 @@
 // Package writers — генерация Go-файлов ресурсов и registry.go.
+//
+// Генерирует три типа файлов в internal/resources_gen/:
+//   - {id}_{service}_resource.go  — основной CRUD инстанса
+//   - {id}_{service}_{sub}_resource.go — подресурсы
+//   - {id}_{service}_{action}_action.go — action-ресурсы (редко)
+//   - registry.go — AllResources() со списком всех ресурсов
+//
+// Каждый файл компилируется через text/template и форматируется через gofmt.
 package writers
 
 import (