docs: rewrite devops/README.md + add TOOLS/README.md

- Updated all paths from universal_rebuild to provider and TOOLS/ - Added pipeline diagram and script reference table - Added TOOLS/README.md with build instructions for each generator
2026-07-05 10:35:45 +04:00
parent f1a9b9b23c
commit d49f19460d
2 changed files with 108 additions and 79 deletions
@@ -0,0 +1,41 @@
+# TOOLS — Генераторы Terraform-провайдера Nubes
+
+Каждый инструмент — независимый Go-модуль.
+
+## yaml-generator
+
+API Nubes → `resources_yaml/*.yaml`
+
+```bash
+cd yaml-generator && go build -o ../bin/yaml-generator .
+./bin/yaml-generator
+```
+
+Структура: `main.go` + `internal/{client,config,normalize,spec,types}`.
+
+## resource-generator
+
+`resources_yaml/*.yaml` → `internal/resources_gen/*.go` + `registry.go`
+
+```bash
+cd resource-generator && go build -o ../bin/resource-generator .
+./bin/resource-generator
+```
+
+Структура: `main.go` + `internal/{helpers,loader,params,templates,types,writers}`.
+
+## docs-generator
+
+`resources_yaml/*.yaml` → Markdown-документация в `docs/30_registry/resources/`
+
+```bash
+cd docs-generator && go build -o ../bin/docs-generator .
+
+# Документация ресурсов
+./bin/docs-generator
+
+# Operations-документация  
+./bin/docs-generator --ops
+```
+
+Структура: `main.go` + `internal/{types,writers,ops}`.