docs: link documentation environments

This commit is contained in:
“Naeel”
2026-09-03 17:26:20 +03:00
parent ccb458a167
commit bba6b47dc2
2 changed files with 23 additions and 3 deletions
@@ -0,0 +1,15 @@
# Cross-stand links on documentation index pages
## Change
The generated resource index now includes a short "Other environments" section with links to the DEV, TEST, and PROD documentation home pages. The links are added in `TOOLS/docs-generator/internal/writers/writers.go`, the actual source of `generated/<stand>/docs/index.md`.
## Publication
All three profiles were regenerated and built sequentially. Only the resulting `index.html` was transferred to the corresponding active VM mirror:
- `/var/www/tf-docs/nubes-dev/index.html`
- `/var/www/tf-docs/nubes-test/index.html`
- `/var/www/tf-docs/nubes/index.html`
Each remote file was checked for the three cross-stand links. The regular S3 mirror continued to report `unexpected EOF`, so direct VM transfer was used again.
@@ -89,6 +89,11 @@ func IndexMD(docsDir string, specs []types.ServiceSpec) {
var b bytes.Buffer
b.WriteString("# Ресурсы провайдера\n\n")
b.WriteString("## Другие стенды\n\n")
b.WriteString("Основные страницы документации для проверки конфигураций на других стендах:\n\n")
b.WriteString("- [DEV](https://tf-docs.nodejsk8s.dev.nubes.ru/nubes-dev/) — разработка и интеграция.\n")
b.WriteString("- [TEST](https://tf-docs.nodejsk8s.dev.nubes.ru/nubes-test/) — тестирование перед PROD.\n")
b.WriteString("- [PROD](https://tf-docs.nodejsk8s.dev.nubes.ru/nubes/) — рабочий стенд.\n\n")
order := []string{"Базы данных", "Очереди", "Хранилище", "K8s", "VMware", "Приложения", "Сеть", "Другие"}
for _, cat := range order {