add upgrade guide for 3.0.0 (#286)
diff --git a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
index 6598047..55e3080 100644
--- a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading.md
@@ -5,4 +5,5 @@
* [2.0.1 升级 2.1.0指导](upgrading/2_0_1T2_1_0.md)
* [2.1.0 升级 2.1.1指导](upgrading/2_1_0T2_1_1.md)
* [2.1.1 升级 2.1.5指导](upgrading/2_1_1T2_1_5.md)
-* [2.1.5 升级 2.6.0指导](upgrading/2_1_5T2_6_0.md)
\ No newline at end of file
+* [2.1.5 升级 2.6.0指导](upgrading/2_1_5T2_6_0.md)
+* [2.8.x 升级 3.0.0指导](upgrading/2_8_0T3_0_0.md)
diff --git a/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_8_0T3_0_0.md b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_8_0T3_0_0.md
new file mode 100644
index 0000000..1f8f92e
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/featured-topics/upgrading/2_8_0T3_0_0.md
@@ -0,0 +1,63 @@
+# 2.8.x 升级 3.0.0 指导
+
+3.0.0版本的重要更新：
+
+* 最小支持 JDK 17
+* 采用Spring Boot 3作为开发底座，底层实现依赖Spring Boot 3，不再提供Spring启动方式。
+
+本文档提供2.8.x升级到3.0.0的指导。
+
+## 依赖配置和启动类
+
+### Java Chassis原生Transport
+
+Java Chassis原生提供了 Rest Over Vert.x, Highway等原生Transport。Edge Service也使用原生Transport运行。
+
+>>> TODO
+
+### Spring Boot Servlet Transport
+
+Java Chassis支持运行与Servlet容器，自身作为一个Servlet启动。
+
+>>> TODO
+
+### 独立WEB容器 Servlet Transport
+
+Java Chassis支持运行与Servlet容器，自身作为一个Servlet启动。
+
+>>> TODO
+
+## 配置项不在支持 `cse` 前缀
+
+Java Chassis 的所有配置项全部使用 `servicecomb` 作为前缀，比如：
+
+```yaml
+servicecomb:
+ service:
+ application: my-application
+ name: my-service
+```
+
+早期版本，也支持下面的配置：
+
+```yaml
+cse:
+ service:
+ application: my-application
+ name: my-service
+```
+
+3.0.0 版本不再提供 `cse` 前缀支持，需要将 `cse` 前缀修改为 `servicecomb`。
+
+## 移除 log4j , logback 的封装
+
+Java Chassis 系统内部全部采用 `slf4j` 记录日志， 不再提供 log4j 的封装功能， 删除了 Log4jUtils 等类。 如果使用了 Log4jUtils 类来初始化日志， 可以参考 [配置日志](../../general-development/config-logs.md) 来设置系统日志。
+
+## 移除 bizkeeper 处理链
+
+Java Chassis 早期版本基于 `Hystrix` 提供了基于方法的服务治理能力，由于社区已经停止 `Hystrix` 维护，并且 `bizkeeper` 设计上不能很好的满足场景的故障模式保护， 3.0.0 版本删除了这个模块。 服务治理可以使用流量特征治理来实现。
+
+## 提供新的 archetypes 插件
+
+>>> TODO
+
diff --git a/java-chassis-reference/zh_CN/docs/general-development/config-logs.md b/java-chassis-reference/zh_CN/docs/general-development/config-logs.md
index bf4051e..c4fa74c 100644
--- a/java-chassis-reference/zh_CN/docs/general-development/config-logs.md
+++ b/java-chassis-reference/zh_CN/docs/general-development/config-logs.md
@@ -8,10 +8,18 @@
使用 log4j2 需要在项目中提供如下依赖。
```xml
- <dependency>
- <groupId>org.apache.logging.log4j</groupId>
- <artifactId>log4j-slf4j-impl</artifactId>
- </dependency>
+<dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-slf4j-impl</artifactId>
+</dependency>
+<dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-api</artifactId>
+</dependency>
+<dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-core</artifactId>
+</dependency>
```
* log4j
@@ -38,4 +46,4 @@
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
</dependency>
-```
\ No newline at end of file
+```
diff --git a/java-chassis-reference/zh_CN/docs/start/first-sample.md b/java-chassis-reference/zh_CN/docs/start/first-sample.md
index f95c674..a9379d5 100644
--- a/java-chassis-reference/zh_CN/docs/start/first-sample.md
+++ b/java-chassis-reference/zh_CN/docs/start/first-sample.md
@@ -153,7 +153,7 @@
开发者也可以通过如下方式快速构建一个项目：
-* 下载samples项目。java-chassis提供了大量的示例代码，这些示例代码可以通过[servicecomb-samples](https://github.com/apache/servicecomb-samples)获取。
+* 下载samples项目。java-chassis提供了大量的示例代码，这些示例代码可以通过 [servicecomb-samples](https://github.com/apache/servicecomb-samples) 获取。
* [Spring MVC例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/springmvc-sample)
* [JaxRS例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/jaxrs-sample)
