an audit for some changes (#40680)

curriculum/challenges/chinese/05-apis-and-microservices/mongodb-and-mongoose/chain-search-query-helpers-to-narrow-search-results.md

@@ -7,11 +7,20 @@ forumTopicId: 301533
 
 # --description--
 
-如果不给 `Model.find()`（或者别的搜索方法）的最后一个参数传入回调函数, 查询将不会执行。你可以将查询条件存储在变量中供以后使用，我们也可以通过链式调用这类变量来构建新的查询字段。实际的数据库操作会在最终调用 `.exec()` 方法时执行。需要注意的是，你必须给 `exec()` 传一个回调方法。Mongoose 为我们提供了许多查询辅助函数, 这里我们使用最著名的一种。
+如果不给 `Model.find()`（或者别的搜索方法）的最后一个参数传入回调函数, 查询将不会执行。你可以将查询条件存储在变量中供以后使用，我们也可以通过链式调用这类变量来构建新的查询字段。实际的数据库操作会在最终调用 `.exec()` 方法时执行。需要注意的是，你必须给 `exec()` 传一个回调方法。并且你必须把回调函数传给最后一个方法。Mongoose 为我们提供了许多查询辅助函数, 这里我们使用最著名的一种。
 
 # --instructions--
 
-找出喜欢 `burrito` 的人并按 `name` 进行排序。同时，我们需要隐藏他们的 `age` 属性。结果应限制在两个 document 内。请链式调用 `.find()`、`.sort()`、`.limit()` 和 `.select()`。最后调用 `.exec()`，并传入给它传入 `done(err, data)` 回调函数。
+修改 `queryChain` 函数来用变量 `foodToSearch` 来查询喜欢指定食物的人。找出喜欢 `burrito` 的人并按 `name` 进行排序。同时，我们需要隐藏他们的 `age` 属性。结果应限制在两个 document 内。请链式调用 `.find()`、`.sort()`、`.limit()` 和 `.select()`，在最后调用 `.exec()` 并给它传入 `done(err, data)` 回调函数。
+
+## 拓展阅读
+
+如果你想进一步了解，你可以参看：
+
+-   索引( Indexes， 对查询效率非常重要 ),
+-   Pre/Post hooks,
+-   Validation,
+-   Schema 虚拟、模型、静态和实例方法
 
 # --hints--
 
@@ -64,5 +73,14 @@ forumTopicId: 301533
   );
 ```
 
+# --seed--
+
 # --solutions--
 
+```js
+/**
+  后端挑战不需要 solutions， 
+  因为他们需要使用一个完整的项目进行测试。 
+  请查询我们的贡献指南以了解更多信息。 
+*/
+```

curriculum/challenges/chinese/05-apis-and-microservices/mongodb-and-mongoose/create-a-model.md

@@ -7,11 +7,11 @@ forumTopicId: 301535
 
 # --description--
 
-**C**RUD 第一小节—CREATE
+**C**RUD 第一小节——CREATE
 
 首先，我们需要一个 Schema（架构、模式或纲要，详情请参阅[维基百科](https://en.wikipedia.org/wiki/Database_schema)），每一个 Schema 都对应一个 MongoDB 的 [collection](https://docs.mongodb.com/manual/reference/glossary/#term-collection)，并且在相应的 collection 里定义 [documents](https://docs.mongodb.com/manual/reference/glossary/#term-document) 的“样子”。 Schema 用于组成 Model（模型），我们甚至可以通过嵌套 Schema 来创建复杂的模型。但是这里我们只学习 Schema 的基础用法。 我们可以根据模型创建实例，模型实例化后的对象称为 documents。
 
-Repl.it 是一个真实的服务器。习惯上，我们会编写函数来处理外界与服务器中数据库的交互，这些函数会在特定事件发生（比如有人调用了我们的服务器 API）时执行。接下来的挑战题目即是以此为基础。`done()` 是一个回调函数，它的作用是在一个异步操作（比如对数据库进行插入、搜索、更新或删除）执行完成时，通知我们可以继续执行后续的其它代码。这与 Node.js 中的处理方式十分类似。在 Node.js 中，我们会在（异步操作）成功时调用 `done(null, data)`，在失败时调用 `done(err)`。
+Repl.it 是一个真实的服务器。习惯上，我们会编写函数来处理外界与服务器中数据库的交互，这些函数会在特定事件发生（比如有人调用了我们的服务器 API）时执行。接下来的挑战题目即是以此为基础。`done()` 是一个回调函数，它的作用是在一个异步操作（比如对数据库进行插入、查询、更新或删除）执行完成时，通知我们可以继续执行后续的其它代码。这与 Node.js 中的处理方式十分类似，在 Node.js 中，我们会在（异步操作）成功时调用 `done(null, data)`，在失败时调用 `done(err)`。
 
 注意：与远程服务器进行交互时，我们需要考虑到发生错误的可能
 
@@ -27,15 +27,19 @@ var someFunc = function(done) {
 
 # --instructions--
 
-以此为原型创建一个 Person：
+按下面的原型信息创建一个名为 `personSchema` 的 schema：
 
-<blockquote>
-- Person 的原型 -<br>
---------------------<br>
-name : string [required]<br>
-age :  number<br>
+```markup
+- Person 的原型 -
+--------------------
+name : string [required]
+age  : number
 favoriteFoods : array of strings (*)
-</blockquote>
+```
+
+采用 Mongoose 基础 schema 类型。你如果还想添加更多的键，就请使用 required 或 unique 等简单的验证器（validators），并设置默认值。详情请参考 [Mongoose 文档](http://mongoosejs.com/docs/guide.html)。
+
+请从 `personSchema` 创建一个名为 `Person` 的 model。
 
 # --hints--
 
@@ -72,5 +76,14 @@ favoriteFoods : array of strings (*)
   );
 ```
 
+# --seed--
+
 # --solutions--
 
+```js
+/**
+  后端挑战不需要 solutions， 
+  因为他们需要使用一个完整的项目进行测试。 
+  请查询我们的贡献指南以了解更多信息。 
+*/
+```

curriculum/challenges/chinese/05-apis-and-microservices/mongodb-and-mongoose/create-many-records-with-model.create.md

@@ -56,5 +56,14 @@ forumTopicId: 301537
   );
 ```
 
+# --seed--
+
 # --solutions--
 
+```js
+/**
+  后端挑战不需要 solutions， 
+  因为他们需要使用一个完整的项目进行测试。 
+  请查询我们的贡献指南以了解更多信息。 
+*/
+```

curriculum/challenges/chinese/05-apis-and-microservices/mongodb-and-mongoose/use-model.find-to-search-your-database.md

@@ -1,15 +1,19 @@
 ---
 id: 587d7fb7367417b2b2512c0b
-title: 使用model.find（）搜索数据库
+title: 使用 model.find() 查询数据库
 challengeType: 2
 forumTopicId: 301543
 ---
 
 # --description--
 
-使用 `Model.find() -> [Person]` 找出符合名字查询条件的所有人。
+我们尝试一种最简单的用法，`Model.find()` 接收一个查询 document（一个 JSON 对象）作为第一个参数，一个回调函数作为第二个参数，它会返回由匹配到的数据组成的数组。这个方法支持很多搜索选项，详情请参阅文档。
 
-`Model.find()` 接收一个查询 document（一个 JSON 对象）作为第一个参数，然后第二个参数是一个回调函数，它会返回由匹配到的数据组成的数组。这个方法支持很多搜索选项，详情请参阅文档。在这个挑战中，请使用 `personName` 作为搜索条件。
+# --instructions--
+
+请使用 `Model.find() -> [Person]` 修改 `findPeopleByName` 函数，以查询全部拥有指定姓名的人。
+
+请使用函数参数中的 `personName` 作为搜索条件。
 
 # --hints--
 
@@ -37,5 +41,14 @@ forumTopicId: 301543
   );
 ```
 
+# --seed--
+
 # --solutions--
 
+```js
+/**
+  后端挑战不需要 solutions， 
+  因为他们需要使用一个完整的项目进行测试。 
+  请查询我们的贡献指南以了解更多信息。 
+*/
+```

curriculum/challenges/chinese/05-apis-and-microservices/mongodb-and-mongoose/use-model.findone-to-return-a-single-matching-document-from-your-database.md

@@ -1,17 +1,17 @@
 ---
 id: 587d7fb7367417b2b2512c0c
-title: 使用 model.findOne() 从数据库中返回一个匹配的 document
+title: 使用 model.findOne() 从数据库中返回一个单一匹配的 Document
 challengeType: 2
 forumTopicId: 301545
 ---
 
 # --description--
 
-`Model.findOne()` 与 `Model.find()` 十分类似。但就算数据库中有很多条数据可以匹配查找条件，`Model.findOne()` 也只返回一个 document，而不会返回一个数组。如果查找的条件是一个值唯一的属性，`Model.findOne()` 会更加适用。
+`Model.findOne()` 与 `Model.find()` 十分类似。但就算数据库中有很多条数据可以匹配查询条件，`Model.findOne()` 也只返回一个 document，而不会返回一个数组。如果查询条件是声明为唯一值的属性，`Model.findOne()` 会更加适用。
 
 # --instructions--
 
-用一个特定的 food 作为 `Model.findOne() -> Person` 的查找参数，来寻找喜欢食物列表中包含给定食物的某一个人。
+修改 `findOneByFood` 函数，用 `Model.findOne() -> Person` 来查询在收藏夹中有某种食物的一个人。将函数参数中的 `food` 作为检索条件。
 
 # --hints--
 
@@ -39,5 +39,14 @@ forumTopicId: 301545
   );
 ```
 
+# --seed--
+
 # --solutions--
 
+```js
+/**
+  后端挑战不需要 solutions， 
+  因为他们需要使用一个完整的项目进行测试。 
+  请查询我们的贡献指南以了解更多信息。 
+*/
+```

curriculum/challenges/english/05-apis-and-microservices/mongodb-and-mongoose/use-model.findone-to-return-a-single-matching-document-from-your-database.md

@@ -7,7 +7,7 @@ forumTopicId: 301545
 
 # --description--
 
-`Model.findOne()` behaves like `.find()`, but it returns only one document (not an array), even if there are multiple items. It is especially useful when searching by properties that you have declared as unique.
+`Model.findOne()` behaves like `Model.find()`, but it returns only one document (not an array), even if there are multiple items. It is especially useful when searching by properties that you have declared as unique.
 
 # --instructions--