diff --git a/docs/upgrade_guide/0.6.0-upgrade-guide.md b/docs/upgrade_guide/0.6.0-upgrade-guide.md
new file mode 100644
index 0000000..0b1afd1
--- /dev/null
+++ b/docs/upgrade_guide/0.6.0-upgrade-guide.md
@@ -0,0 +1,10 @@
+# Pack 0.6.0 Migration Guide
+
+This document is meant to help you migrate your application to Pack 0.6.0 by providing thematic sections that mirror the developer guide.
+
+## Omega Components
+
+Rename @Compensable annotation property `retries`  to `forwardRetries`
+
+Rename @Compensable annotation property `timeout`  to `forwardTimeout`
+
diff --git a/docs/upgrade_guide/0.6.0-upgrade-guide_zh.md b/docs/upgrade_guide/0.6.0-upgrade-guide_zh.md
new file mode 100644
index 0000000..4d0ad7d
--- /dev/null
+++ b/docs/upgrade_guide/0.6.0-upgrade-guide_zh.md
@@ -0,0 +1,10 @@
+# Pack 0.6.0 升级指南
+
+本文档提供与开发人员指南相对应的主题部分，帮助您将应用程序迁移到Pack 0.6.0
+
+## Omega 组件
+
+@Compensable 注解的 `retries` 属性改名为 `forwardRetries`
+
+@Compensable 注解的 `timeout` 属性改名为 `forwardTimeout`
+
diff --git a/docs/user_guide.md b/docs/user_guide.md
index 5885aff..2b98727 100644
--- a/docs/user_guide.md
+++ b/docs/user_guide.md
@@ -820,3 +820,7 @@
 ## Experiment
 
 [State Machine Mode](fsm/fsm_manual.md)
+
+## Upgrade Guide
+
+[Pack 0.6.0 Migration Guide](./upgrade_guide/0.6.0-upgrade_guide.md)
\ No newline at end of file
diff --git a/docs/user_guide_zh.md b/docs/user_guide_zh.md
index 1af0eee..235ff39 100644
--- a/docs/user_guide_zh.md
+++ b/docs/user_guide_zh.md
@@ -807,3 +807,8 @@
 ## 实验
 
 [状态机模式](fsm/fsm_manual_zh.md)
+
+## 升级指南
+
+[Pack 0.6.0 升级指南](./upgrade_guide/0.6.0-upgrade_guide_zh.md)
+