Merge pull request #22 from WeBankFinTech/develop

merge to master

README.rst

@@ -74,10 +74,10 @@ WeIdentity支持认证机构自行注册标准化凭证模板，共同丰富公
 ^^^^
 
 *
-   `案例及场景 <docs/use-cases.html>`_
+   `案例及场景 <https://weidentity.readthedocs.io/zh_CN/latest/docs/use-cases.html>`_
 
 *
-   `WeIdentity规范文档 <docs/weidentity-spec.html>`_
+   `WeIdentity规范文档 <https://weidentity.readthedocs.io/zh_CN/latest/docs/weidentity-spec.html>`_
 
 
 开始使用

docs/en/README.rst

@@ -21,7 +21,7 @@ Decentralized Identifiers (WeIdentity DID)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Traditionally, user identity is issued and managed by single centralized organization. With the advent of blockchain technology, it is possible to publish and distribute user identity on chain to allow more than one organization to manage on as a multi-centers solution
-WeIdentity DID Module has come with a distributed identification protocol based on \ `FISCO-BCOS Blockchain Platform <https://fisco-bcos-documentation-en.readthedocs.io/en/latest/>`_\ , and \ `W3C DID specification <https://w3c-ccg.github.io/did-spec/>`_\, to create identities on chain and associate it with any person or object in the real world. Moreover, DID ensures the Subject’s owner with full rights of control and ownership of the identities.
+WeIdentity DID Module has come with a distributed identification protocol based on \ `FISCO-BCOS Blockchain Platform <https://fisco-bcos-documentation-en.readthedocs.io/en/latest/>`_\ , and \ `W3C DID specification <https://w3c-ccg.github.io/did-spec/>`_\, to create identities on chain and associate it with any person or object in the real world. Moreover, DID ensures the Entity with full rights of control and ownership of the identities.
 
 The design goals of WeIdentity DID:
 

docs/zh_CN/README.rst

@@ -19,7 +19,7 @@ WeIdentity目前主要包含两大模块：WeIdentity DID以及WeIdentity Creden
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 传统方式中，用户的注册和身份管理完全依赖于单一中心的注册机构；随着分布式账本技术（例如区块链）的出现，分布式多中心的身份注册、标识和管理成为可能。
-WeIdentity DID模块在\ `FISCO-BCOS区块链底层平台 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/>`_\ 上实现了一套符合\ `W3C DID规范 <https://w3c-ccg.github.io/did-spec/>`_\ 的分布式多中心的身份标识协议，使实体（人或物）的现实身份实现了链上的身份标识；同时，WeIdentity DID给与Subject（人或者物）直接拥有和控制自己身份ID的能力。
+WeIdentity DID模块在\ `FISCO-BCOS区块链底层平台 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/>`_\ 上实现了一套符合\ `W3C DID规范 <https://w3c-ccg.github.io/did-spec/>`_\ 的分布式多中心的身份标识协议，使实体（人或物）的现实身份实现了链上的身份标识；同时，WeIdentity DID给与Entity（人或者物）直接拥有和控制自己身份ID的能力。
 
 WeIdentity DID秉承以下设计理念：
 
@@ -72,10 +72,10 @@ WeIdentity支持认证机构自行注册标准化凭证模板，共同丰富公
 ^^^^
 
 *
-   `案例及场景 <docs/use-cases.html>`_
+   `案例及场景 <https://weidentity.readthedocs.io/zh_CN/latest/docs/use-cases.html>`_
 
 *
-   `WeIdentity规范文档 <docs/weidentity-spec.html>`_
+   `WeIdentity规范文档 <https://weidentity.readthedocs.io/zh_CN/latest/docs/weidentity-spec.html>`_
 
 
 开始使用

docs/zh_CN/docs/terminologies.rst

@@ -61,7 +61,7 @@
      - 用于路由到不同的网络
    * - Service Endpoint
      - 服务端点
-     - Subject暴露的服务的地址，例如暴露自己的Credential托管的服务地址，暴露自己的文件存储服务地址
+     - Entity暴露的服务的地址，例如暴露自己的Credential托管的服务地址，暴露自己的文件存储服务地址
    * - publish
      - 发布
      - 一个Issuer（包括Authority Issuer）发行一种新的CPT，这个动作称为publish
@@ -76,13 +76,13 @@
      - 由权威机构发行的与实体关联的数据，通过摘要算法与签名算法，在保证数据隐私前提下，实现数据不可篡改与可验证
    * - Issuer
      - 凭证发行者
-     - 任意拥有WeIdentity DID的Subject都可以作为Issuer来发行Credential
+     - 任意拥有WeIdentity DID的Entity都可以作为Issuer来发行Credential
    * - Authority Issuer
      - 权威凭证发行者
      - 例如对Claim进行认证的权威机构或者可信机构，例如下发驾照的交通事务局
-   * - Subject
-     - 主体
-     - WeIdentity Document或Credential描述的主体，即拥有WeIdentity DID的人或者物
+   * - Entity
+     - 实体
+     - WeIdentity Document或Credential描述的实体，即拥有WeIdentity DID的人或者物
    * - Verifier
      - 凭证验证者
      - 使用凭证的第三方，会验证这个凭证是否经过权威机构认证，例如劳工局办理业务时需要用户提供驾照，这时劳工局就是Verifier

docs/zh_CN/docs/weidentity-spec.rst

@@ -129,7 +129,7 @@ WeIdentity DID = did:weid:net-id:bs-specific-string
    * - net-id
      - 网络id，用于路由到不同的网络
    * - bs-specific-string
-     - 基于底层区块链平台生成，代表Subject在链上的地址，保证全网唯一
+     - 基于底层区块链平台生成，代表Entity在链上的地址，保证全网唯一
 
 
 备注：bsSpecificString根据区块链底层平台和业务具体情况来确定生成规则，例如可以是随机字符串，或者区块链上的地址。
@@ -147,7 +147,7 @@ WeIdentity Document格式
    * - @context
      - 用于描述WeIdentity Document结构等信息
    * - id
-     - WeIdentity DID，表示当前Document描述的subject，用于自描述
+     - WeIdentity DID，表示当前Document描述的Entity，用于自描述
    * - created
      - Document的创建时间
    * - updated
@@ -159,9 +159,9 @@ WeIdentity Document格式
    * - publicKey.type
      - 用于指定signature suite
    * - publicKey.owner
-     - 指定控制对应私钥的Subject，遵从WeIdentity规范，如果为空，则表明owner是Document的id字段，如果是Credential类Subject，则owner一般是某用户
+     - 指定控制对应私钥的Entity，遵从WeIdentity规范，如果为空，则表明owner是Document的id字段，如果是Credential类Entity，则owner一般是某用户
    * - authentication
-     - 用于Subject证明其与当前Document的关联性
+     - 用于Entity证明其与当前Document的关联性
    * - authentication.type
      - 用于指定signature suite
    * - authentication.publicKey
@@ -255,7 +255,7 @@ WeIdentity DID支持操作
 
       * - 角色
         - 说明
-      * - User (Subject)
+      * - User (Entity)
         - 用户（实体）。会注册属于自己的WeIdentity DID，申请Credential，并通过出示给相关业务方来使用之。
       * - Issuer
         - Credential的发行者。会首先验证实体对WeIdentity DID的所有权，其次发行Credential交给实体。
@@ -449,7 +449,7 @@ Credential操作
 验证Credential
 ~~~~~~~~~~~~~~
 
-通过这个接口，一个Subject可以对一个Credential进行验证。
+通过这个接口，一个Entity可以对一个Credential进行验证。
 
 存储/提取Credential
 ~~~~~~~~~~~~~~~~~~~