From 573f9566b1ac0acbdaa8d330e38ea1dfa54fab1a Mon Sep 17 00:00:00 2001
From: Jack251970 <1160210343@qq.com>
Date: Sat, 8 Mar 2025 15:22:53 +0800
Subject: [PATCH 1/2] Use Remark comments to show example string

---
 .../Localize/LocalizeSourceGenerator.cs       | 27 ++++++++++++-------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs b/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
index 1d48f6e..2c0ac44 100644
--- a/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
+++ b/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
@@ -446,22 +446,31 @@ private static void GeneratedHeaderFromPath(StringBuilder sb, string xamlFilePat
 
         private static void GenerateDocComments(StringBuilder sb, LocalizableString ls, string tabString)
         {
-            if (ls.Summary != null)
+            if (!string.IsNullOrEmpty(ls.Summary))
             {
-                sb.AppendLine($"{tabString}/// <summary>");
-                foreach (var line in ls.Summary.Split('\n'))
+                var summaryLines = ls.Summary.Split('\n');
+                if (summaryLines.Length > 0)
                 {
-                    sb.AppendLine($"{tabString}/// {line.Trim()}");
+                    sb.AppendLine($"{tabString}/// <summary>");
+                    foreach (var line in summaryLines)
+                    {
+                        sb.AppendLine($"{tabString}/// {line.Trim()}");
+                    }
+                    sb.AppendLine($"{tabString}/// </summary>");
                 }
-                sb.AppendLine($"{tabString}/// </summary>");
             }
 
-            sb.AppendLine($"{tabString}/// <code>");
-            foreach (var line in ls.Value.Split('\n'))
+            var lines = ls.Value.Split('\n');
+            if (lines.Length > 0)
             {
-                sb.AppendLine($"{tabString}/// {line.Trim()}");
+                sb.AppendLine($"{tabString}/// <remarks>");
+                sb.AppendLine($"{tabString}/// e.g.:");
+                foreach (var line in lines)
+                {
+                    sb.AppendLine($"{tabString}/// {line.Trim()}");
+                }
+                sb.AppendLine($"{tabString}/// </remarks>");
             }
-            sb.AppendLine($"{tabString}/// </code>");
         }
 
         private static void GenerateLocalizationMethod(

From e830b88d7e4afa4f7c800bfa91cef4a2cf66ede8 Mon Sep 17 00:00:00 2001
From: Jack251970 <1160210343@qq.com>
Date: Sat, 8 Mar 2025 21:29:39 +0800
Subject: [PATCH 2/2] Improve comment format

---
 .../Localize/LocalizeSourceGenerator.cs                        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs b/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
index 2c0ac44..0dac33d 100644
--- a/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
+++ b/Flow.Launcher.Localization.SourceGenerators/Localize/LocalizeSourceGenerator.cs
@@ -464,11 +464,12 @@ private static void GenerateDocComments(StringBuilder sb, LocalizableString ls,
             if (lines.Length > 0)
             {
                 sb.AppendLine($"{tabString}/// <remarks>");
-                sb.AppendLine($"{tabString}/// e.g.:");
+                sb.AppendLine($"{tabString}/// e.g.: <code>");
                 foreach (var line in lines)
                 {
                     sb.AppendLine($"{tabString}/// {line.Trim()}");
                 }
+                sb.AppendLine($"{tabString}/// </code>");
                 sb.AppendLine($"{tabString}/// </remarks>");
             }
         }