feat: curated examples in sidebar nav via WriteNavFragment — PG+user+DB example

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

@@ -77,6 +77,16 @@ func IndexMD(docsDir string, specs []types.ServiceSpec) {
 		catMap[cat] = append(catMap[cat], s)
 	}
 
+	// Check which services have curated examples
+	hasCurated := map[string]bool{}
+	if entries, err := os.ReadDir("docs/curated"); err == nil {
+		for _, e := range entries {
+			if e.IsDir() {
+				hasCurated[e.Name()] = true
+			}
+		}
+	}
+
 	var b bytes.Buffer
 	b.WriteString("# Ресурсы провайдера\n\n")
 
@@ -1119,6 +1129,16 @@ func WriteNavFragment(docsDir string, specs []types.ServiceSpec) {
 		catMap[cat] = append(catMap[cat], s)
 	}
 
+	// Check which services have curated examples
+	hasCurated := map[string]bool{}
+	if entries, err := os.ReadDir("docs/curated"); err == nil {
+		for _, e := range entries {
+			if e.IsDir() {
+				hasCurated[e.Name()] = true
+			}
+		}
+	}
+
 	var b bytes.Buffer
 	b.WriteString("# auto-generated by docs-generator — DO NOT EDIT\n")
 	b.WriteString("resources_nav:\n")
@@ -1142,6 +1162,9 @@ func WriteNavFragment(docsDir string, specs []types.ServiceSpec) {
 			b.WriteString(fmt.Sprintf("      - Выходные данные: %s_outputs.md\n", s.Name))
 			b.WriteString(fmt.Sprintf("      - Операции: %s_ops.md\n", s.Name))
 			b.WriteString(fmt.Sprintf("      - Пример: %s_example.md\n", s.Name))
+if hasCurated[s.Name] {
+b.WriteString(fmt.Sprintf("      - 💡 Примеры из практики: curated/%s/pg_user_db.md\n", s.Name))
+}
 		}
 	}