* update document

readthedocs/zh_CN/docs/faq.md

@@ -320,30 +320,36 @@ Evidence的key是数据的hash值（通过WeIdentity SDK提供的sha3函数计
 
 - **联盟链管理员丢失了私钥怎么办？**
 
-在使用可视化工具过程中，如果联盟链管理员丢失了私钥，则说明当前的合约数据都不安全了，需要重新配置并部署合约，具体操作如下:
+在使用可视化工具过程中，如果联盟链管理员丢失了私钥，那当前的智能合约部分需要管理员才具有的写权限就丢失了，可以重新配置并部署智能合约，具体操作如下:
 
-1.进入tools/目录升级链上数据桶版本
 
-完成此操作之前请确保output/admin目录中存在新的私钥，如果没有新私钥，请先通过可视化工具配置管理员新私钥
+完成此操作之前请确保 `output/admin` 目录中存在新的私钥，如果没有新私钥，请先通过'WeIdentity 部署工具'生成一个新的管理员私钥。
 
-.. code-block:: shell
+1.清理历史数据
 
+从'WeIdentity 部署工具'的根目录进入 `tools/` 目录。
+
+* 注意，执行下面的命令会清理掉链上 CNS 和智能合约的数据，等于让之前的所有的数据都失效了（不能再通过CNS访问，而智能通过合约地址访问）。
+
+```
   cd tools
   chmod u+x upgrade_databucket.sh
   ./upgrade_databucket.sh
+```
 
-2. 删除weid-build-tools指引文件
-
-.. code-block:: shell
+2. 删除 `weid-build-tools` 指引文件。
 
+```
   cd ..
   rm -r output/other/guide
+```
 
 3. 重启服务
 
-.. code-block:: shell
-
+```
   ./stop.sh
   ./start.sh
-
+```
+
+4. 重新进入网页，即可从 0 开始。
 ---

readthedocs/zh_CN/docs/weidentity-installation-by-web-with-sources.rst

@@ -1,9 +1,9 @@
 .. role:: raw-html-m2r(raw)
    :format: html
 
-.. _weidentity-installation-by-sourcecode:
+.. _weidentity-installation-by-web-with-sources:
 
-WeIdentity 安装部署工具使用文档（可视化源码安装部署方式）
+‘WeIdentity 部署工具’安装文档（下载源代码进行安装）
 =====================================================
 
 整体介绍
@@ -18,34 +18,39 @@ WeIdentity 安装部署工具使用文档（可视化源码安装部署方式）
 ---------------------------------
 
 
-.. note::
-     服务器在海外的用户，可以参考这个文档，安装速度可能会更快： `WeIdentity 安装部署工具海外用户安装步骤： <./weidentity-installation-by-web-overseas.html>`_ 。
-
-
 1.下载源码
 """""""""""""""
 
 .. code-block:: shell
 
-  git clone https://gitee.com/WeBank/WeIdentity-Build-Tools.git
+    git clone https://gitee.com/WeBank/WeIdentity-Build-Tools.git
+
+
+.. note::
+    服务器在海外的用户，可以从github上下载： :code:`git clone git@github.com:WeBankFinTech/WeIdentity-Build-Tools.git`
+
 
 2.切换分支并给脚本授权
-"""""""""""""""
+"""""""""""""""""""""""""""
 
 .. code-block:: shell
-  cd WeIdentity-Build-Tools
-  chmod u+x *.sh
+
+    cd WeIdentity-Build-Tools
+    chmod u+x *.sh
+
 
 3.编译项目
 """""""""""""""
 
 .. code-block:: shell
-  ./build.sh
-  
-  .. note::
-     此步骤将自动下载gradle版本, 如果此步骤很慢可自行安装 gradle5.6+ 并执行: gradle build
-  
-  
+
+    ./build.sh
+
+
+.. note::
+   此步骤将自动下载 gradle 版本, 如果此步骤很慢可自行安装 gradle5.6+ 并执行： :code:`gradle build`
+
+
 3.启动Web服务
 """"""""""""""
 
@@ -57,10 +62,10 @@ WeIdentity 安装部署工具使用文档（可视化源码安装部署方式）
 
 .. code-block:: shell
 
------------------------------------------------
-The weid-build-tools web server started successfully.
-The weid-build-tools web server url : http://127.0.0.1:6021
------------------------------------------------
+    -----------------------------------------------
+    The weid-build-tools web server started successfully.
+    The weid-build-tools web server url : http://127.0.0.1:6021
+    -----------------------------------------------
 
 
 4.安装完成
@@ -70,11 +75,9 @@ The weid-build-tools web server url : http://127.0.0.1:6021
 
 * 可以使用可视化的方式完成 WeIdentity 的部署：通过 :code:`http://127.0.0.1:6021` （IP 替换为自己服务器的IP）访问部署工具的 Web 页面，详见文档：\ `部署文档（可视化部署方式） <./deploy-via-web.html>`_\，完成 WeIdentity 的部署和其他相关配置。
 
-* 也可以使用命令行的方式完成部署，详见文档：\ `部署文档（命令行部署方式） <./deploy-via-commandline.html>`_\ ，完成 WeIdentity 的部署和其他相关配置。
-
 
 插件安装
-----
+--------
 
 安装fisco-bcos-browser
 """"""""""""""""""""""""""""""""
@@ -85,29 +88,29 @@ The weid-build-tools web server url : http://127.0.0.1:6021
 
 .. code-block:: shell
 
-  cd common/script/install
-  chmod u+x *.sh
+    cd common/script/install
+    chmod u+x *.sh
 
 2.执行安装脚本
 
 .. code-block:: shell
 
-  ./plugin_install.sh -n webase
-  
+    ./plugin_install.sh -n webase
+
 出现下列输出，则表示Web服务启动成功。
 
 .. code-block:: shell
 
---------------------------------------------------------------------------
-fisco-bcos-browser is installed successfully, please go to the fisco-bcos-browser/server directory and start the server.
-Example: cd fisco-bcos-browser/server && ./start.sh
---------------------------------------------------------------------------
+    --------------------------------------------------------------------------
+    fisco-bcos-browser is installed successfully, please go to the fisco-bcos-browser/server directory and start the server.
+    Example: cd fisco-bcos-browser/server && ./start.sh
+    --------------------------------------------------------------------------
 
 3.进入fisco-bcos-browser服务目录，并且启动服务
- 
+
 .. code-block:: shell
 
-  cd fisco-bcos-browser/server
-  ./start.sh
+    cd fisco-bcos-browser/server
+    ./start.sh
 
 4.可以通过可视化工具进行访问fisco-bcos-browser