diff --git a/cmd/internal/config.go b/cmd/internal/config.go
index afce5de9fcb0..ae73511f1c2a 100644
--- a/cmd/internal/config.go
+++ b/cmd/internal/config.go
@@ -242,6 +242,11 @@ func processValue(v any, isToolset bool) any {
 			if item.Key == "kind" {
 				item.Key = "type"
 			}
+			if item.Key == "description" {
+				if s, ok := item.Value.(string); ok {
+					item.Value = strings.TrimSpace(strings.ReplaceAll(s, "\n", " "))
+				}
+			}
 			// Recursive call for nested values (e.g., nested objects or lists)
 			item.Value = processValue(item.Value, false)
 			newVal[i] = item
diff --git a/issues.json b/issues.json
new file mode 100644
index 000000000000..67f55dbbd5fd
--- /dev/null
+++ b/issues.json
@@ -0,0 +1,4 @@
+{
+    "number": 3023,
+    "title": "migration add \\n instead of separating lines for description"
+}