From 4271bd9fa9688745dd219ded8d24077cc8edafb3 Mon Sep 17 00:00:00 2001
From: Jack251970 <1160210343@qq.com>
Date: Sun, 21 Sep 2025 00:27:32 +0800
Subject: [PATCH 1/2] Improve documents about xaml comments

---
 localization-toolkit.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/localization-toolkit.md b/localization-toolkit.md
index 247ac58..15af6f7 100644
--- a/localization-toolkit.md
+++ b/localization-toolkit.md
@@ -59,6 +59,24 @@ To this:
 Localize.flowlauncher_plugin_localization_demo_value_with_keys(firstName, lastName);
 ```
 
+If you would like to add summry for functions of localization strings, you need to comment strings in xaml files like this:
+```xml
+<!--
+<summary>Demo plugin name</summary>
+-->
+<system:String x:Key="flowlauncher_plugin_localization_demo_plugin_name">Demo</system:String>
+```
+
+Or if you would like to change the default types or names of variables in localization strings, you need to comment strings in xaml file like this:
+```xml
+<!--
+<param index="0" name="value0" type="object" />
+<param index="1" name="value1" type="string" />
+<param index="2" name="value2" type="int" />
+-->
+<system:String x:Key="flowlauncher_plugin_localization_demo_value_with_keys">Demo {2:00}, {1,-35:D} and {0}</system:String>
+```
+
 ### Localized Enums
 
 For enum types (e.g., `DemoEnum`) that need localization in UI controls such as combo boxes, use the `EnumLocalize` attribute to enable localization. For each enum field:

From c8eae405804c6fb33e69b3850b85f55e7055d1a6 Mon Sep 17 00:00:00 2001
From: Jack Ye <1160210343@qq.com>
Date: Sun, 21 Sep 2025 00:54:12 +0800
Subject: [PATCH 2/2] Fix typos

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 localization-toolkit.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/localization-toolkit.md b/localization-toolkit.md
index 15af6f7..a9f6ba2 100644
--- a/localization-toolkit.md
+++ b/localization-toolkit.md
@@ -59,7 +59,7 @@ To this:
 Localize.flowlauncher_plugin_localization_demo_value_with_keys(firstName, lastName);
 ```
 
-If you would like to add summry for functions of localization strings, you need to comment strings in xaml files like this:
+If you would like to add summary for functions of localization strings, you need to comment strings in xaml files like this:
 ```xml
 <!--
 <summary>Demo plugin name</summary>