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/params/params.go

@@ -1,4 +1,11 @@
 // Package params — слияние, фильтрация, анализ параметров и ForceNew.
+//
+// Основные операции:
+//   - Merge — объединяет параметры из нескольких операций по Code
+//   - ComputeCreateOnly — поля, которые есть в create, но отсутствуют в modify
+//   - BuildSubresourceForceNewCodes — поля, требующие пересоздания subresource
+//   - Analyze — определяет используемые типы (bool/int64/string) для импортов
+//   - AnalyzePlanModifiers — ForceNew-поля, требующие planmodifier.*.RequiresReplace()
 package params
 
 import (