Sync Chinese translation to 20190415 & add principles link to nav (xitu#99)

* fix variables link

* Correct the misunderstanding of the original text

* Sync Chinese translation to 20190415 & add `principles` link to nav

Author: ydfzgyj

site/_core/HeaderLinks.js

@@ -12,8 +12,10 @@ const links = [
   { section: 'learn', text: '学习', href: '/learn/' },
   { section: 'code', text: '代码', href: '/code/' },
   { section: 'community', text: '社区', href: '/community/' },
-  { section: 'spec', text: '规范', href: 'http://spec.graphql.cn/' },
+  { section: 'spec', text: '规范', href: 'https://spec.graphql.cn/' },
+  { section: 'codeofconduct', text: '行为守则', href: '/codeofconduct/' },
   { section: 'foundation', text: '基金会', href: 'https://foundation.graphql.org/' },
+  { section: 'principles', text: '开发原则', href: 'https://principles.graphql.cn/' },
 ];
 
 export default ({ section }) =>

site/codeofconduct/CodeOfConduct.md

@@ -0,0 +1,50 @@
+---
+title: 行为守则
+layout: ../_core/DocsLayout
+category: 行为守则
+permalink: /codeofconduct/
+---
+
+# GraphQL 行为守则 v1.0
+
+## 我们的承诺
+
+为了营造一个开放和热情的环境，我们作为贡献者和维护者承诺任何人都能不受困扰的参与我们的项目和社区，无论年龄、体型、是否残疾、种族、性别特征、性别认同和表达、经验水平、教育、社会经济地位、国籍、个人形象、种族、宗教、或是性别认同和取向。
+
+## 我们的标准
+
+以下是有助于创造积极环境的行为范例：
+
+* 使用欢迎和包容的语言
+* 尊重不同的观点和经验
+* 优雅地接受建设性的批评
+* 关注对社区最有利的事情
+* 表现出对其他社区成员的同情
+
+以下是参与者不可接受的行为案例：
+
+* 使用色情语言或图像以及不受欢迎的性关注或求爱
+* 恶意破坏、侮辱/贬损评论以及个人或政治攻击
+* 公开或私下的骚扰
+* 发布他人的私人信息，例如未经明确许可的实体或电子地址
+* 在专业环境中可被合理地认为不合适的其他行为
+
+## 我们的责任
+
+GraphQL 规范成员、项目参与者和贡献者（统称“参与者”）负责澄清可接受行为的标准，并且应该采取适当和公平的纠正措施来应对任何不可接受的行为。
+
+GraphQL 规范的指导委员会有权力和责任删除、编辑或拒绝与本行为守则不一致的评论、提交、代码、维基编辑、议题和其他贡献，也可以暂时或永久性的禁止他们认为不合适的来自任何参与者的具有威胁性、攻击性或有害性的其他行为。
+
+所有参与者都认定 Linux 基金会是最适合此项目开发的组织。参与者承认并同意 Linux 基金会拥有“GraphQL”以及与 GraphQL 开源项目和 GraphQL 规范相关的任何其他名称和商标的专利权，并授权他人使用这些商标，确定此类使用的指导方针以及分派这些职责。参与者同意不采取任何与此类权利不一致的行为，并配合 Linux 基金会认为必要或可取的任何行动，以防止混淆或确立或保留这些权利。参与者不会独立采用、使用或尝试注册与这些名称混淆或相似的任何商标或商品名称。
+
+## 适用范围
+
+本行为守则适用于项目空间和某一个体代表项目或其社区时的公共领域中。代表项目或社区的示例包括使用一个官方的项目电子邮件地址、通过官方社交媒体帐户发布信息或是作为线上或线下活动的指定代表。项目维护人员可以进一步定义和澄清对于项目的陈述。
+
+## 执行
+
+可以通过联系执行主管报告滥用、骚扰或其他不可接受行为的情况。如果投诉涉及执行主管，则联系指导委员会的成员。所有投诉都将得到审查和调查，并给出必要且适合当时情况的回复。项目团队有义务为事件报告者保密。具体执行政策的进一步细节可以单独发布。未真诚遵守或执行本行为守则的参与者可能会面临由指导委员会确定的暂时或永久性影响。
+
+## 来源
+
+本行为守则改编自贡献者契约 1.4 版，可以从 [https://www.contributor-covenant.org/version/1/4/code-of-conduct.html](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html) 获取。有关本行为守则的常见问题的解答，请参阅 [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq)。

site/learn/BestPractice-Pagination.md

@@ -78,7 +78,7 @@ next: /learn/caching/
 
 现在我们有能力使用游标对连接进行分页，但是我们如何知道何时到达连接的结尾？我们必须继续查询，直到我们收到一个空列表，但是我们真的希望连接能够告诉我们什么时候到达结尾，这样我们不需要额外的请求。同样的，如果我们想知道关于连接本身的附加信息怎么办；例如，R2-D2 有多少个朋友？
 
-为了解决这两个问题，我们的 `friends` 字段可以返回一个连接对象。然后，连接对象将具有边其中的字段以及其他信息（如总计数和有关下一页是否存在的信息）。所以我们的最终查询可能看起来像这样：
+为了解决这两个问题，我们的 `friends` 字段可以返回一个连接对象。连接对象将拥有一个存放边的字段以及其他信息（如总计数和有关下一页是否存在的信息）。所以我们的最终查询可能看起来像这样：
 
 
 ```graphql

site/learn/Learn-Queries.md

@@ -126,7 +126,7 @@ fragment comparisonFields on Character {
 
 ### 在片段内使用变量
 
-片段可以访问查询或变更中声明的变量。详见 [变量](learn/queries/#variables)。
+片段可以访问查询或变更中声明的变量。详见 [变量](#variables)。
 
 ```graphql
 # { "graphiql": true }

site/learn/Learn-Schema.md

@@ -311,6 +311,7 @@ union SearchResult = Human | Droid | Starship
 # { "graphiql": true}
 {
   search(text: "an") {
+    __typename
     ... on Human {
       name
       height
@@ -327,6 +328,33 @@ union SearchResult = Human | Droid | Starship
 }
 ```
 
+`_typename` 字段解析为 `String`，它允许你在客户端区分不同的数据类型。
+
+此外，在这种情况下，由于 `Human` 和 `Droid` 共享一个公共接口（`Character`），你可以在一个地方查询它们的公共字段，而不必在多个类型中重复相同的字段：
+
+```graphql
+{
+  search(text: "an") {
+    __typename
+    ... on Character {
+      name
+    }
+    ... on Human {
+      height
+    }
+    ... on Droid {
+      primaryFunction
+    }
+    ... on Starship {
+      name
+      length
+    }
+  }
+}
+```
+
+注意 `name` 仍然需要指定在 `Starship` 上，否则它不会出现在结果中，因为 `Starship` 并不是一个 `Character`！
+
 ### 输入类型（Input Types） 
 
 目前为止，我们只讨论过将例如枚举和字符串等标量值作为参数传递给字段，但是你也能很容易地传递复杂对象。这在变更（mutation）中特别有用，因为有时候你需要传递一整个对象作为新建对象。在 GraphQL schema language 中，输入对象看上去和常规对象一模一样，除了关键字是 `input` 而不是 `type`：