diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..1e127853
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,34 @@
+# [rpcx](http://rpcx.site)
+
+## 4.0
+
+- Support utp and rudp
+- Add OneClient to support invoke multile servicesby one client
+- Finish compress feature
+- Add more plugins for monitoring connection
+- Support dynamic port allocation
+- Use go module to manage dependencies
+- Support shutdown graceful
+- Add [rpcx-java](https://github.com/smallnest/rpcx-java) to support develop raw java services and clients
+- Support thrift codec 
+- Setup rpcx offcial site: http://rpcx.site
+- Add Chinese document: http://doc.rpcx.site or https://smallnest.gitbooks.io/go-rpc-programming-guide
+
+## 3.1
+
+- Add http gateway: https://github.com/rpcx-ecosystem/rpcx-gateway
+- Add direct http invoke
+- Add bidirectional communication 
+- Add xgen tool to generate codes for services automatically
+
+
+fix bugs.
+
+## 3.0
+
+- Rewrite rpcx. It implements its protocol and won't implemented based on wrapper of go standard rpc lib
+- Add go tags for pluggable plugins
+- Add English document: https://github.com/smallnest/rpcx-programming
+- Add rpcx 3.0 examples: https://github.com/rpcx-ecosystem/rpcx-examples3
+
+rpcx 3.0 is not compatible with rpcx 2.0 and below
\ No newline at end of file
diff --git a/README.md b/README.md
index 21168643..3deaca27 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ you can use other programming languages besides Go to access rpcx services.
 
 - **rpcx-gateway**: You can write clients in any programming languages to call rpcx services via [rpcx-gateway](https://github.com/rpcx-ecosystem/rpcx-gateway)
 - **http invoke**: you can use the same http requests to access rpcx gateway
-- **Java Client**: You can use [rpcx-java](https://github.com/smallnest/rpcx-java) to access rpcx servies via raw protocol.
+- **Java Services/Clients**: You can use [rpcx-java](https://github.com/smallnest/rpcx-java) to implement/access rpcx servies via raw protocol.
 
 
 > If you can write Go methods, you can also write rpc services. It is so easy to write rpc applications with rpcx.