MISC: 文档问题修复
diff --git a/bin/publish_gitbook.sh b/bin/publish_gitbook.sh
index 0d7cd29..b0acf49 100755
--- a/bin/publish_gitbook.sh
+++ b/bin/publish_gitbook.sh
@@ -6,33 +6,33 @@
STATIC_TMP_DIR="~/gh-pages-tmp"
if [ ! -d ~/gh-pages-tmp ] ; then
- git clone -b gh-pages https://github.com/dubbo/dubbo-docs.git ~/gh-pages-tmp
+ git clone -b gh-pages https://github.com/dubbo/dubbo-docs.git $STATIC_TMP_DIR
fi
cd $DEPLOY_DIR/user-guide
gitbook build .
-cp -rf ./_book/* ~/gh-pages-tmp/user-guide
+cp -rf ./_book/* $STATIC_TMP_DIR/user-guide
rm -rf ./_book
cd $DEPLOY_DIR/developer-guide
gitbook build .
-cp -rf ./_book/* ~/gh-pages-tmp/developer-guide
+cp -rf ./_book/* $STATIC_TMP_DIR/developer-guide
rm -rf ./_book
cd $DEPLOY_DIR/admin-guide
gitbook build .
-cp -rf ./_book/* ~/gh-pages-tmp/admin-guide
+cp -rf ./_book/* $STATIC_TMP_DIR/admin-guide
rm -rf ./_book
-cd ~/gh-pages-tmp
+cd $STATIC_TMP_DIR
filelist=`ls -1`
for filename in $filelist ; do
if [ -f "$filename" ] ; then
echo $filename
- cp -rf ./$filename ~/gh-pages-tmp/
+ cp -rf ./$filename $STATIC_TMP_DIR/
elif [ -d "$filename" ] && [ ! "$filename" == "user-guide" -a ! "$filename" == "developer-guide" -a ! "$filename" == "admin-guide" ] ; then
- cp -rf ./$filename ~/gh-pages-tmp/
+ cp -rf ./$filename $STATIC_TMP_DIR/
fi
done
@@ -41,4 +41,4 @@
git push -u origin gh-pages
cd ~
-rm -rf ~/dubbo-docs-gh-pages-tmp
+rm -rf $STATIC_TMP_DIR
diff --git a/user-guide/README.md b/user-guide/README.md
index c20fa38..f893950 100644
--- a/user-guide/README.md
+++ b/user-guide/README.md
@@ -1,3 +1,3 @@
-这篇文档详细描述了`dubbo`的使用，基本涵盖dubbo的所有功能特性。
+这篇文档详细讲解了`dubbo`的使用，基本涵盖`dubbo`的所有功能特性。
-如果你正依赖`dubbo`作为你业务工程的RPC通信框架，这将是你的参考手册
+如果你正依赖`dubbo`作为你业务工程的RPC通信框架，这里可以作为你的参考手册
diff --git a/user-guide/SUMMARY.md b/user-guide/SUMMARY.md
index 241b62e..4b3231c 100644
--- a/user-guide/SUMMARY.md
+++ b/user-guide/SUMMARY.md
@@ -32,7 +32,7 @@
* [4.18 泛化实现](demos/泛化实现.md)
* [4.19 回声测试](demos/回声测试.md)
* [4.20 上下文信息](demos/上下文信息.md)
- * [4.21 隐式参数](demos/隐式参数.md)
+ * [4.21 隐式参数](demos/隐式传参.md)
* [4.22 异步调用](demos/异步调用.md)
* [4.23 本地调用](demos/本地调用.md)
* [4.24 参数回调](demos/参数回调.md)
@@ -55,39 +55,39 @@
* [4.41 服务容器](demos/服务容器.md)
* [4.42 Reference Config缓存](demos/ReferenceConfig缓存.md)
* [4.43 分布式事务](demos/分布式事务.md)
- * [5 API参考手册](reference-apiconf/api.md)
-* [5 schema配置参考手册](reference-xmlconf/introduction.md)
- * [5.1 dubbo:service](reference-xmlconf/dubbo-service.md)
- * [5.2 dubbo:reference](reference-xmlconf/dubbo-reference.md)
- * [5.3 dubbo:protocol](reference-xmlconf/dubbo-protocol.md)
- * [5.4 dubbo:registry](reference-xmlconf/dubbo-registry.md)
- * [5.5 dubbo:monitor](reference-xmlconf/dubbo-monitor.md)
- * [5.6 dubbo:application](reference-xmlconf/dubbo-application.md)
- * [5.7 dubbo:module](reference-xmlconf/dubbo-module.md)
- * [5.8 dubbo:provider](reference-xmlconf/dubbo-provider.md)
- * [5.9 dubbo:consumer](reference-xmlconf/dubbo-consumer.md)
- * [5.10 dubbo:method](reference-xmlconf/dubbo-method.md)
- * [5.11 dubbo:argument](reference-xmlconf/dubbo-argument.md)
- * [5.12 dubbo:parameter](reference-xmlconf/dubbo-parameter.md)
-* [6 协议参考手册](reference-protocol/introduction.md)
- * [6.1 dubbo://](reference-protocol/dubbo.md)
- * [6.2 rmi//](reference-protocol/rmi.md)
- * [6.3 hessian://](reference-protocol/hessian.md)
- * [6.4 http://](reference-protocol/http.md)
- * [6.5 webservice://](reference-protocol/webservice.md)
- * [6.6 thrift://](reference-protocol/thrift.md)
- * [6.7 memcached://](reference-protocol/memcached.md)
- * [6.8 redis://](reference-protocol/redis.md)
-* [7 注册中心参考手册](reference-registry/introduction.md)
- * [7.1 Multicast注册中心](reference-registry/multicast.md)
- * [7.2 Zookeeper注册中心](reference-registry/zookeeper.md)
- * [7.3 Redis注册中心](reference-registry/redis.md)
- * [7.4 Simple注册中心](reference-registry/simple.md)
-* [8 telnet命令参考手册](reference-telnet/telnet.md)
-* [9 maven插件参考手册](reference-maven/maven.md)
-* [10 服务化最佳实践](best-practice.md)
-* [11 推荐用法](recommend.md)
-* [12 容量规划](capacity-plan.md)
-* [13 基准测试工具包](benchmark.md)
-* [14 性能测试报告](perf-test.md)
-* [15 测试覆盖率报告](coveragence.md)
\ No newline at end of file
+* [5 API参考手册](reference-apiconf/api.md)
+* [6 schema配置参考手册](reference-xmlconf/introduction.md)
+ * [6.1 dubbo:service](reference-xmlconf/dubbo-service.md)
+ * [6.2 dubbo:reference](reference-xmlconf/dubbo-reference.md)
+ * [6.3 dubbo:protocol](reference-xmlconf/dubbo-protocol.md)
+ * [6.4 dubbo:registry](reference-xmlconf/dubbo-registry.md)
+ * [6.5 dubbo:monitor](reference-xmlconf/dubbo-monitor.md)
+ * [6.6 dubbo:application](reference-xmlconf/dubbo-application.md)
+ * [6.7 dubbo:module](reference-xmlconf/dubbo-module.md)
+ * [6.8 dubbo:provider](reference-xmlconf/dubbo-provider.md)
+ * [6.9 dubbo:consumer](reference-xmlconf/dubbo-consumer.md)
+ * [6.10 dubbo:method](reference-xmlconf/dubbo-method.md)
+ * [6.11 dubbo:argument](reference-xmlconf/dubbo-argument.md)
+ * [6.12 dubbo:parameter](reference-xmlconf/dubbo-parameter.md)
+* [7 协议参考手册](reference-protocol/introduction.md)
+ * [7.1 dubbo://](reference-protocol/dubbo.md)
+ * [7.2 rmi//](reference-protocol/rmi.md)
+ * [7.3 hessian://](reference-protocol/hessian.md)
+ * [7.4 http://](reference-protocol/http.md)
+ * [7.5 webservice://](reference-protocol/webservice.md)
+ * [7.6 thrift://](reference-protocol/thrift.md)
+ * [7.7 memcached://](reference-protocol/memcached.md)
+ * [7.8 redis://](reference-protocol/redis.md)
+* [8 注册中心参考手册](reference-registry/introduction.md)
+ * [8.1 Multicast注册中心](reference-registry/multicast.md)
+ * [8.2 Zookeeper注册中心](reference-registry/zookeeper.md)
+ * [8.3 Redis注册中心](reference-registry/redis.md)
+ * [8.4 Simple注册中心](reference-registry/simple.md)
+* [9 telnet命令参考手册](reference-telnet/telnet.md)
+* [10 maven插件参考手册](reference-maven/maven.md)
+* [11 服务化最佳实践](best-practice.md)
+* [12 推荐用法](recommend.md)
+* [13 容量规划](capacity-plan.md)
+* [14 基准测试工具包](benchmark.md)
+* [15 性能测试报告](perf-test.md)
+* [16 测试覆盖率报告](coveragence.md)
\ No newline at end of file
diff --git a/user-guide/configuration/properties.md b/user-guide/configuration/properties.md
index 8186aed..4aa372e 100644
--- a/user-guide/configuration/properties.md
+++ b/user-guide/configuration/properties.md
@@ -1,5 +1,7 @@
> 如果公共配置很简单，没有多注册中心，多协议等情况，或者想多个Spring容器想共享配置，可以使用dubbo.properties作为缺省配置。
+
> Dubbo将自动加载classpath根目录下的dubbo.properties，可以通过JVM启动参数：-Ddubbo.properties.file=xxx.properties 改变缺省配置位置。
+
> 如果classpath根目录下存在多个dubbo.properties，比如多个jar包中有dubbo.properties，Dubbo会任意加载，并打印Error日志，后续可能改为抛异常。
**映射规则：**
diff --git a/user-guide/configuration/xml.md b/user-guide/configuration/xml.md
index 0820243..1124c20 100644
--- a/user-guide/configuration/xml.md
+++ b/user-guide/configuration/xml.md
@@ -1,11 +1,11 @@
> **配置项说明**
-> 详细配置项，请参见：配置参考手册 (+)
+> 详细配置项，请参见：[配置参考手册](../reference-xmlconf/introduction.md)
> **API使用说明**
-如果不想使用Spring配置，而希望通过API的方式进行调用，请参见：API配置 (+)
+如果不想使用Spring配置，而希望通过API的方式进行调用，请参见：[API配置](./api.md)
> **配置使用说明**
-想知道如何使用配置，请参见：快速启动 (+)
+想知道如何使用配置，请参见：[tutorials](../preface/usage.md)
示例：
<center style="align=center;">provider.xml</center>
@@ -29,7 +29,7 @@
如：
``` xml
<dubbo:protocol name="jms">
- <dubbo:parameter key="queue" value="http://10.20.160.198/wiki/display/dubbo/10.20.31.22" />
+ <dubbo:parameter key="queue" value="your_queue" />
</dubbo:protocol>
```
或：(2.1.0开始支持)
@@ -40,7 +40,7 @@
xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
xmlns:p="http://www.springframework.org/schema/p"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
- <dubbo:protocol name="jms" p:queue="http://10.20.160.198/wiki/display/dubbo/10.20.31.22" />
+ <dubbo:protocol name="jms" p:queue="your_queue" />
</beans>
```
**Configuration Relation:**
diff --git "a/user-guide/demos/\344\270\212\344\270\213\346\226\207\344\277\241\346\201\257.md" "b/user-guide/demos/\344\270\212\344\270\213\346\226\207\344\277\241\346\201\257.md"
index 670ed04..9118cdd 100644
--- "a/user-guide/demos/\344\270\212\344\270\213\346\226\207\344\277\241\346\201\257.md"
+++ "b/user-guide/demos/\344\270\212\344\270\213\346\226\207\344\277\241\346\201\257.md"
@@ -1,6 +1,6 @@
> 上下文中存放的是当前调用过程中所需的环境信息。
-> 所有配置信息都将转换为URL的参数，参见 [配置项一览表](/user-guide/reference-xmlconf/introduction.md) 中的“对应URL参数”一列。
+> 所有配置信息都将转换为URL的参数，参见 [配置项一览表](../reference-xmlconf/introduction.md) 中的“对应URL参数”一列。
> **注意**
RpcContext是一个ThreadLocal的临时状态记录器，当接收到RPC请求，或发起RPC请求时，RpcContext的状态都会变化。
diff --git "a/user-guide/demos/\344\274\230\351\233\205\345\201\234\346\234\272.md" "b/user-guide/demos/\344\274\230\351\233\205\345\201\234\346\234\272.md"
index ce26852..770f525 100644
--- "a/user-guide/demos/\344\274\230\351\233\205\345\201\234\346\234\272.md"
+++ "b/user-guide/demos/\344\274\230\351\233\205\345\201\234\346\234\272.md"
@@ -1,4 +1,4 @@
-> Dubbo是通过JDK的ShutdownHook来完成优雅停机的，所以如果用户使用"kill -9 PID"等强制关闭指令，是不会执行优雅停机的，只有通过"kill PID"时，才会执行。
+>  Dubbo是通过JDK的ShutdownHook来完成优雅停机的，所以如果用户使用"kill -9 PID"等强制关闭指令，是不会执行优雅停机的，只有通过"kill PID"时，才会执行。
**原理**
diff --git "a/user-guide/demos/\345\210\206\347\273\204\350\201\232\345\220\210.md" "b/user-guide/demos/\345\210\206\347\273\204\350\201\232\345\220\210.md"
index f66fcb6..45fd40b 100644
--- "a/user-guide/demos/\345\210\206\347\273\204\350\201\232\345\220\210.md"
+++ "b/user-guide/demos/\345\210\206\347\273\204\350\201\232\345\220\210.md"
@@ -1,4 +1,5 @@
> 按组合并返回结果，比如菜单服务，接口一样，但有多种实现，用group区分，现在消费方需从每种group中调用一次返回结果，合并结果返回，这样就可以实现聚合菜单项。
+
> 从2.1.0版本开始支持,
代码参见：https://github.com/alibaba/dubbo/tree/master/dubbo-test/dubbo-test-examples/src/main/java/com/alibaba/dubbo/examples/merge
@@ -34,7 +35,7 @@
```
**指定合并策略，缺省根据返回值类型自动匹配，如果同一类型有两个合并器时，需指定合并器的名称**
-参见：[合并结果扩展](dev-guide-spi-reference-manual#合并结果扩展)
+参见：[合并结果扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E5%90%88%E5%B9%B6%E7%BB%93%E6%9E%9C%E6%89%A9%E5%B1%95.html)
```xml
<dubbo:reference interface="com.xxx.MenuService" group="*">
diff --git "a/user-guide/demos/\345\217\202\346\225\260\345\233\236\350\260\203.md" "b/user-guide/demos/\345\217\202\346\225\260\345\233\236\350\260\203.md"
index 73c6136..61c5074 100644
--- "a/user-guide/demos/\345\217\202\346\225\260\345\233\236\350\260\203.md"
+++ "b/user-guide/demos/\345\217\202\346\225\260\345\233\236\350\260\203.md"
@@ -1,6 +1,7 @@
> 参数回调方式与调用本地callback或listener相同，只需要在Spring的配置文件中声明哪个参数是callback类型即可，Dubbo将基于长连接生成反向代理，这样就可以从服务器端调用客户端逻辑。
> 2.0.6及其以上版本支持
+
> 代码参见：https://github.com/alibaba/dubbo/tree/master/dubbo-test/dubbo-test-examples/src/main/java/com/alibaba/dubbo/examples/callback
##### (1) 共享服务接口
diff --git "a/user-guide/demos/\345\217\202\346\225\260\351\252\214\350\257\201.md" "b/user-guide/demos/\345\217\202\346\225\260\351\252\214\350\257\201.md"
index 8e10f9c..5a7cb2f 100644
--- "a/user-guide/demos/\345\217\202\346\225\260\351\252\214\350\257\201.md"
+++ "b/user-guide/demos/\345\217\202\346\225\260\351\252\214\350\257\201.md"
@@ -2,7 +2,7 @@
> 2.1.0以上版本支持, 完整示例代码参见：https://github.com/alibaba/dubbo/tree/master/dubbo-test/dubbo-test-examples/src/main/java/com/alibaba/dubbo/examples/validation
-验证方式可扩展，参见：[验证扩展](dev-guide-spi-reference-manual#验证扩展)
+验证方式可扩展，参见：[验证扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E9%AA%8C%E8%AF%81%E6%89%A9%E5%B1%95.html)
##### 参数标注示例
diff --git "a/user-guide/demos/\345\220\257\345\212\250\346\227\266\346\243\200\346\237\245.md" "b/user-guide/demos/\345\220\257\345\212\250\346\227\266\346\243\200\346\237\245.md"
index 0af8d79..1ff6fdb 100644
--- "a/user-guide/demos/\345\220\257\345\212\250\346\227\266\346\243\200\346\237\245.md"
+++ "b/user-guide/demos/\345\220\257\345\212\250\346\227\266\346\243\200\346\237\245.md"
@@ -1,4 +1,5 @@
> Dubbo缺省会在启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止Spring初始化完成，以便上线时，能及早发现问题，默认 `check="true"`。
+
> 如果你的Spring容器是懒加载的，或者通过API编程延迟引用服务，请关闭check，否则服务临时不可用时，会抛出异常，拿到null引用，如果 `check="false"`，总是会返回引用，当服务恢复时，能自动连上。
可以通过 `check="false"` 关闭检查，比如，测试时，有些服务不关心，或者出现了循环依赖，必须有一方先启动。
diff --git "a/user-guide/demos/\345\244\232\345\215\217\350\256\256.md" "b/user-guide/demos/\345\244\232\345\215\217\350\256\256.md"
index 048a714..7f16f9b 100644
--- "a/user-guide/demos/\345\244\232\345\215\217\350\256\256.md"
+++ "b/user-guide/demos/\345\244\232\345\215\217\350\256\256.md"
@@ -1,4 +1,4 @@
-可以自行扩展协议，参见：[协议扩展](dev-guide-spi-reference-manual#协议扩展)
+可以自行扩展协议，参见：[协议扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E5%8D%8F%E8%AE%AE%E6%89%A9%E5%B1%95.html)
##### (1) 不同服务不同协议
diff --git "a/user-guide/demos/\345\244\232\346\263\250\345\206\214\344\270\255\345\277\203.md" "b/user-guide/demos/\345\244\232\346\263\250\345\206\214\344\270\255\345\277\203.md"
index da95801..dfb8a2f 100644
--- "a/user-guide/demos/\345\244\232\346\263\250\345\206\214\344\270\255\345\277\203.md"
+++ "b/user-guide/demos/\345\244\232\346\263\250\345\206\214\344\270\255\345\277\203.md"
@@ -1,4 +1,4 @@
-可以自行扩展注册中心，参见：[注册中心扩展](dev-guide-spi-reference-manual#注册中心扩展)
+可以自行扩展注册中心，参见：[注册中心扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E6%B3%A8%E5%86%8C%E4%B8%AD%E5%BF%83%E6%89%A9%E5%B1%95.html)
##### (1) 多注册中心注册
diff --git "a/user-guide/demos/\345\273\266\350\277\237\346\232\264\351\234\262.md" "b/user-guide/demos/\345\273\266\350\277\237\346\232\264\351\234\262.md"
index 54128ea..5edcb16 100644
--- "a/user-guide/demos/\345\273\266\350\277\237\346\232\264\351\234\262.md"
+++ "b/user-guide/demos/\345\273\266\350\277\237\346\232\264\351\234\262.md"
@@ -26,7 +26,7 @@
> 而Spring初始化线程，先锁beanDefinitionMap，再锁singletonObjects。反向锁导致线程死锁，不能提供服务，启动不了。
-> ****规避办法**
+> **规避办法**
>
> 1. 强烈建议不要在服务的实现类中有applicationContext.getBean()的调用，全部采用IoC注入的方式使用Spring的Bean。
> 2. 如果实在要调getBean()，可以将Dubbo的配置放在Spring的最后加载。
diff --git "a/user-guide/demos/\346\227\245\345\277\227\351\200\202\351\205\215.md" "b/user-guide/demos/\346\227\245\345\277\227\351\200\202\351\205\215.md"
index 1c7f7b5..a194ee6 100644
--- "a/user-guide/demos/\346\227\245\345\277\227\351\200\202\351\205\215.md"
+++ "b/user-guide/demos/\346\227\245\345\277\227\351\200\202\351\205\215.md"
@@ -1,5 +1,6 @@
> 2.2.1以上版本支持
-> 扩展点：[日志适配扩展](dev-guide-spi-reference-manual#日志适配扩展)
+
+> 扩展点：[日志适配扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E6%97%A5%E5%BF%97%E9%80%82%E9%85%8D%E6%89%A9%E5%B1%95.html)
缺省自动查找：
diff --git "a/user-guide/demos/\346\234\215\345\212\241\345\256\271\345\231\250.md" "b/user-guide/demos/\346\234\215\345\212\241\345\256\271\345\231\250.md"
index 7337194..b2bb4c0 100644
--- "a/user-guide/demos/\346\234\215\345\212\241\345\256\271\345\231\250.md"
+++ "b/user-guide/demos/\346\234\215\345\212\241\345\256\271\345\231\250.md"
@@ -2,7 +2,7 @@
> 服务容器只是一个简单的Main方法，并加载一个简单的Spring容器，用于暴露服务。
-> 服务容器的加载内容可以扩展，内置了spring, jetty, log4j等加载，可通过Container扩展点进行扩展，参见：[Container](#)。配置配在java命令-D参数或者dubbo.properties中
+> 服务容器的加载内容可以扩展，内置了spring, jetty, log4j等加载，可通过Container扩展点进行扩展，参见：[Container](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E5%AE%B9%E5%99%A8%E6%89%A9%E5%B1%95.html)。配置配在java命令-D参数或者dubbo.properties中
##### Spring Container
diff --git "a/user-guide/demos/\346\234\215\345\212\241\351\231\215\347\272\247.md" "b/user-guide/demos/\346\234\215\345\212\241\351\231\215\347\272\247.md"
index edc7f76..d0e8231 100644
--- "a/user-guide/demos/\346\234\215\345\212\241\351\231\215\347\272\247.md"
+++ "b/user-guide/demos/\346\234\215\345\212\241\351\231\215\347\272\247.md"
@@ -1,6 +1,6 @@
> 2.2.0以上版本支持,
-> 参见：[配置规则](配置规则.md)
+> 参见：[配置规则](./配置规则.md)
向注册中心写入动态配置覆盖规则：(通过由监控中心或治理中心的页面完成)
diff --git "a/user-guide/demos/\346\234\254\345\234\260\345\255\230\346\240\271.md" "b/user-guide/demos/\346\234\254\345\234\260\345\255\230\346\240\271.md"
index ca34dd9..a7d26dc 100644
--- "a/user-guide/demos/\346\234\254\345\234\260\345\255\230\346\240\271.md"
+++ "b/user-guide/demos/\346\234\254\345\234\260\345\255\230\346\240\271.md"
@@ -2,6 +2,7 @@
> Stub必须有可传入Proxy的构造函数。
+
```xml
diff --git "a/user-guide/demos/\347\262\230\346\273\236\350\277\236\346\216\245.md" "b/user-guide/demos/\347\262\230\346\273\236\350\277\236\346\216\245.md"
index dd418e1..b99b22b 100644
--- "a/user-guide/demos/\347\262\230\346\273\236\350\277\236\346\216\245.md"
+++ "b/user-guide/demos/\347\262\230\346\273\236\350\277\236\346\216\245.md"
@@ -1,6 +1,6 @@
> 粘滞连接用于有状态服务，尽可能让客户端总是向同一提供者发起调用，除非该提供者挂了，再连另一台。
-> 粘滞连接将自动开启延迟连接，以减少长连接数, 参见：[延迟连接](延迟连接.md)
+> 粘滞连接将自动开启延迟连接，以减少长连接数, 参见：[延迟连接](./延迟连接.md)
```xml
<dubbo:protocol name="dubbo" sticky="true" />
diff --git "a/user-guide/demos/\347\273\223\346\236\234\347\274\223\345\255\230.md" "b/user-guide/demos/\347\273\223\346\236\234\347\274\223\345\255\230.md"
index 5794917..e373fe4 100644
--- "a/user-guide/demos/\347\273\223\346\236\234\347\274\223\345\255\230.md"
+++ "b/user-guide/demos/\347\273\223\346\236\234\347\274\223\345\255\230.md"
@@ -8,7 +8,7 @@
* `threadlocal` 当前线程缓存，比如一个页面渲染，用到很多portal，每个portal都要去查用户信息，通过线程缓存，可以减少这种多余访问。
* `jcache` 与 [JSR107](http://jcp.org/en/jsr/detail?id=107%27) 集成，可以桥接各种缓存实现。
-缓存类型可扩展，参见：[CacheFactory扩展点](dev-guide-spi-reference-manual#缓存扩展)
+缓存类型可扩展，参见：[CacheFactory扩展点](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E7%BC%93%E5%AD%98%E6%89%A9%E5%B1%95.html)
配置如：
diff --git "a/user-guide/demos/\350\264\237\350\275\275\345\235\207\350\241\241.md" "b/user-guide/demos/\350\264\237\350\275\275\345\235\207\350\241\241.md"
index 9bc926f..f36b688 100644
--- "a/user-guide/demos/\350\264\237\350\275\275\345\235\207\350\241\241.md"
+++ "b/user-guide/demos/\350\264\237\350\275\275\345\235\207\350\241\241.md"
@@ -1,4 +1,4 @@
-> 在集群负载均衡时，Dubbo提供了多种均衡策略，缺省为random随机调用。可以自行扩展负载均衡策略，参见：[负载均衡扩展](dev-guide-spi-reference-manual#负载均衡扩展)
+> 在集群负载均衡时，Dubbo提供了多种均衡策略，缺省为random随机调用。可以自行扩展负载均衡策略，参见：[负载均衡扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E8%B4%9F%E8%BD%BD%E5%9D%87%E8%A1%A1%E6%89%A9%E5%B1%95.html)
##### Random LoadBalance
diff --git "a/user-guide/demos/\350\267\257\347\224\261\350\247\204\345\210\231.md" "b/user-guide/demos/\350\267\257\347\224\261\350\247\204\345\210\231.md"
index a940f74..a661564 100644
--- "a/user-guide/demos/\350\267\257\347\224\261\350\247\204\345\210\231.md"
+++ "b/user-guide/demos/\350\267\257\347\224\261\350\247\204\345\210\231.md"
@@ -1,6 +1,6 @@
> 2.2.0以上版本支持,
-> 路由规则扩展点：[路由扩展](#)
+> 路由规则扩展点：[路由扩展](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E8%B7%AF%E7%94%B1%E6%89%A9%E5%B1%95.html)
向注册中心写入路由规则：(通常由监控中心或治理中心的页面完成)
diff --git "a/user-guide/demos/\350\277\236\346\216\245\346\216\247\345\210\266.md" "b/user-guide/demos/\350\277\236\346\216\245\346\216\247\345\210\266.md"
index a4dd3b6..53a8c08 100644
--- "a/user-guide/demos/\350\277\236\346\216\245\346\216\247\345\210\266.md"
+++ "b/user-guide/demos/\350\277\236\346\216\245\346\216\247\345\210\266.md"
@@ -20,5 +20,5 @@
<dubbo:service interface="com.foo.BarService" connections="10" />
```
-如果 `<dubbo:service>`和 `<dubbo:reference>` 都配了connections，`<dubbo:reference>` 优先，参见：[配置的覆盖策略](user-guide-configuration#配置覆盖)
+如果 `<dubbo:service>`和 `<dubbo:reference>` 都配了connections，`<dubbo:reference>` 优先，参见：[配置的覆盖策略](../configuration/xml.md)
diff --git a/user-guide/preface/usage.md b/user-guide/preface/usage.md
index 436fa92..5a2de18 100644
--- a/user-guide/preface/usage.md
+++ b/user-guide/preface/usage.md
@@ -1 +1,139 @@
-quick start
\ No newline at end of file
+
+Dubbo采用全Spring配置方式，透明化接入应用，对应用没有任何API侵入，只需用Spring加载Dubbo的配置即可，Dubbo基于Spring的Schema扩展进行加载。
+
+如果不想使用Spring配置，而希望通过API的方式进行调用（不推荐），请参见：[API配置](user-guide-configuration#api配置)
+
+#### 服务提供者
+
+> 完整安装步骤，请参见：[示例提供者安装](admin-guide-install-manual#示例提供者安装)
+
+##### 定义服务接口
+
+**DemoService.java**
+
+```java
+package com.alibaba.dubbo.demo;
+
+public interface DemoService {
+
+ String sayHello(String name);
+
+}
+```
+> 该接口需单独打包，在服务提供方和消费方共享
+
+##### 在服务提供方实现接口
+
+**DemoServiceImpl.java**
+
+```java
+
+package com.alibaba.dubbo.demo.provider;
+
+import com.alibaba.dubbo.demo.DemoService;
+
+public class DemoServiceImpl implements DemoService {
+
+ public String sayHello(String name) {
+ return "Hello " + name;
+ }
+
+}
+```
+> 对服务消费方隐藏实现
+
+##### 用 Spring 配置声明暴露服务
+
+**provider.xml**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://www.springframework.org/schema/beans"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
+ xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
+
+ <!-- 提供方应用信息，用于计算依赖关系 -->
+ <dubbo:application name="hello-world-app" />
+
+ <!-- 使用multicast广播注册中心暴露服务地址 -->
+ <dubbo:registry address="multicast://224.5.6.7:1234" />
+
+ <!-- 用dubbo协议在20880端口暴露服务 -->
+ <dubbo:protocol name="dubbo" port="20880" />
+
+ <!-- 声明需要暴露的服务接口 -->
+ <dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoService" />
+
+ <!-- 和本地bean一样实现服务 -->
+ <bean id="demoService" class="com.alibaba.dubbo.demo.provider.DemoServiceImpl" />
+
+</beans>
+```
+
+##### 加载Spring配置
+
+**Provider.java**
+
+```java
+import org.springframework.context.support.ClassPathXmlApplicationContext;
+
+public class Provider {
+ public static void main(String[] args) throws Exception {
+ ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"http://10.20.160.198/wiki/display/dubbo/provider.xml"});
+ context.start();
+
+ System.in.read(); // 按任意键退出
+ }
+}
+```
+
+#### 服务消费者
+
+> 完整安装步骤，请参见：[示例消费者安装](admin-guide-install-manual#示例消费者安装)
+
+##### 通过Spring配置引用远程服务
+
+**consumer.xml**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://www.springframework.org/schema/beans"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
+ xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
+
+ <!-- 消费方应用名，用于计算依赖关系，不是匹配条件，不要与提供方一样 -->
+ <dubbo:application name="consumer-of-helloworld-app" />
+
+ <!-- 使用multicast广播注册中心暴露发现服务地址 -->
+ <dubbo:registry address="multicast://224.5.6.7:1234" />
+
+ <!-- 生成远程服务代理，可以和本地bean一样使用demoService -->
+ <dubbo:reference id="demoService" interface="com.alibaba.dubbo.demo.DemoService" />
+</beans>
+```
+
+##### 加载Spring配置，并调用远程服务
+
+**Consumer.java**
+
+```java
+import org.springframework.context.support.ClassPathXmlApplicationContext;
+import com.alibaba.dubbo.demo.DemoService;
+
+public class Consumer {
+
+ public static void main(String[] args) throws Exception {
+ ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"http://10.20.160.198/wiki/display/dubbo/consumer.xml"});
+ context.start();
+
+ DemoService demoService = (DemoService)context.getBean("demoService"); // 获取远程服务代理
+ String hello = demoService.sayHello("world"); // 执行远程方法
+
+ System.out.println( hello ); // 显示调用结果
+ }
+
+}
+```
+> 也可以使用IoC注入
diff --git a/user-guide/recommend.md b/user-guide/recommend.md
index 310e116..c6b435e 100644
--- a/user-guide/recommend.md
+++ b/user-guide/recommend.md
@@ -30,7 +30,7 @@
3. `actives` 消费者端，最大并发调用限制，即当Consumer对一个服务的并发调用到上限后，新调用会Wait直到超时。
在方法上配置（dubbo:method ）则并发限制针对方法，在接口上配置（dubbo:service），则并发限制针对服务。
-详细配置说明参见：[Dubbo配置参考手册](reference-xmlconf/dubbo-provider.md)
+详细配置说明参见：[Dubbo配置参考手册](./reference-xmlconf/introduction.md)
#### Provider上配置合理的Provider端属性
diff --git a/user-guide/reference-registry/redis.md b/user-guide/reference-registry/redis.md
index 46a3c0e..4d54d92 100644
--- a/user-guide/reference-registry/redis.md
+++ b/user-guide/reference-registry/redis.md
@@ -1,4 +1,4 @@
-> [Redis](http://redis.io) 是一个高效的KV存储服务器。安装方式参见: [Redis安装手册](admin-guide-install-manual#redis注册中心安装)，只需搭一个原生的Redis服务器，并将 [Quick Start](user-guide-quick-start#快速启动) 中Provider和Consumer里的conf/dubbo.properties中的dubbo.registry.addrss的值改为redis://127.0.0.1:6379即可使用。
+> [Redis](http://redis.io) 是一个高效的KV存储服务器。安装方式参见: [Redis安装手册](http://dubbo.io/admin-guide/install-mannual/Redis%E6%B3%A8%E5%86%8C%E4%B8%AD%E5%BF%83%E5%AE%89%E8%A3%85.html)，只需搭一个原生的Redis服务器，并将 [Quick Start](../preface/usage.md) 中Provider和Consumer里的conf/dubbo.properties中的dubbo.registry.addrss的值改为redis://127.0.0.1:6379即可使用。
##### Redis过期数据
diff --git a/user-guide/reference-registry/zookeeper.md b/user-guide/reference-registry/zookeeper.md
index b878279..1cedc5a 100644
--- a/user-guide/reference-registry/zookeeper.md
+++ b/user-guide/reference-registry/zookeeper.md
@@ -4,7 +4,7 @@
[Zookeeper](http://zookeeper.apache.org) 是Apacahe Hadoop的子项目，是一个树型的目录服务，支持变更推送，适合作为Dubbo服务的注册中心，工业强度较高，可用于生产环境，并推荐使用。
> **Zookeeper安装**
-安装方式参见: [Zookeeper安装手册](admin-guide-install-manual#zookeeper注册中心安装)，只需搭一个原生的Zookeeper 服务器，并将 [Quick Start](user-guide-quick-start#快速启动) 中Provider和Consumer里的conf/dubbo.properties中的dubbo.registry.addrss的值改为zookeeper://127.0.0.1:2181即可使用。
+安装方式参见: [Zookeeper安装手册](http://dubbo.io/admin-guide/install-mannual/Zookeeper%E6%B3%A8%E5%86%8C%E4%B8%AD%E5%BF%83%E5%AE%89%E8%A3%85.html)，只需搭一个原生的Zookeeper 服务器，并将 [Quick Start](../preface/usage.md) 中Provider和Consumer里的conf/dubbo.properties中的dubbo.registry.addrss的值改为zookeeper://127.0.0.1:2181即可使用。
> **可靠性声明**
> 阿里内部并没有采用Zookeeper做为注册中心，而是使用自己实现的基于数据库的注册中心，即：Zookeeper注册中心并没有在阿里内部长时间运行的可靠性保障，此Zookeeper桥接实现只为开源版本提供，其可靠性依赖于Zookeeper本身的可靠性。
diff --git a/user-guide/reference-telnet/telnet.md b/user-guide/reference-telnet/telnet.md
index 638c6e6..8ccce2f 100644
--- a/user-guide/reference-telnet/telnet.md
+++ b/user-guide/reference-telnet/telnet.md
@@ -12,8 +12,8 @@
echo status | nc -i 1 localhost 20880
```
-telnet命令可以扩展，参见：[扩展参考手册](dev-guide-spi-reference-manual#telnet命令扩展)。
-status命令所检查的资源也可以扩展，参见：[扩展参考手册](dev-guide-spi-reference-manual#状态检查扩展)。
+telnet命令可以扩展，参见：[扩展参考手册](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/Telnet%E5%91%BD%E4%BB%A4%E6%89%A9%E5%B1%95.html)。
+status命令所检查的资源也可以扩展，参见：[扩展参考手册](http://dubbo.io/developer-guide/SPI%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C/%E7%8A%B6%E6%80%81%E6%A3%80%E6%9F%A5%E6%89%A9%E5%B1%95.html)。
#### ls
diff --git a/user-guide/reference-xmlconf/dubbo-service.md b/user-guide/reference-xmlconf/dubbo-service.md
index c393f60..26ffef6 100644
--- a/user-guide/reference-xmlconf/dubbo-service.md
+++ b/user-guide/reference-xmlconf/dubbo-service.md
@@ -1,3 +1,49 @@
+<style>
+table {
+ width: 100%;
+ max-width: 65em;
+ border: 1px solid #dedede;
+ margin: 15px auto;
+ border-collapse: collapse;
+ empty-cells: show;
+}
+table th,
+table td {
+ height: 35px;
+ border: 1px solid #dedede;
+ padding: 0 10px;
+}
+table th {
+ font-weight: bold;
+ text-align: center !important;
+ background: rgba(158,188,226,0.2);
+ white-space: nowrap;
+}
+table tbody tr:nth-child(2n) {
+ background: rgba(158,188,226,0.12);
+}
+table td:nth-child(1) {
+ white-space: nowrap;
+}
+table tr:hover {
+ background: #efefef;
+}
+.table-area {
+ overflow: auto;
+}
+</style>
+
+<script type="text/javascript">
+[].slice.call(document.querySelectorAll('table')).forEach(function(el){
+ var wrapper = document.createElement('div');
+ wrapper.className = 'table-area';
+ el.parentNode.insertBefore(wrapper, el);
+ el.parentNode.removeChild(el);
+ wrapper.appendChild(el);
+})
+</script>
+
+
服务提供者暴露服务配置：
配置类：com.alibaba.dubbo.config.ServiceConfig
diff --git a/user-guide/reference-xmlconf/introduction.md b/user-guide/reference-xmlconf/introduction.md
index cb6ab5f..bf018c9 100644
--- a/user-guide/reference-xmlconf/introduction.md
+++ b/user-guide/reference-xmlconf/introduction.md
@@ -1,6 +1,6 @@
> 这里以Xml Config为准，列举所有配置项，其它配置方式，请参见相应转换关系：Properties Config，Annotation Config，API Config
-> 注意：只有group，interface，version是服务的匹配条件，三者决定是不是同一个服务，其它配置项均为调优和治理参数。
+> 注意：只有group，interface，version是服务的匹配条件，三者决定是不是同一个服务，其它配置项均为调优和治理参数。
所有配置项分为三大类，参见下表中的"作用"一列。
