From a46c9420603ef9b7db40c2453fb941517672ab4d Mon Sep 17 00:00:00 2001
From: "rust-lang.xfoss.com" <unisko@gmail.com>
Date: Mon, 11 Dec 2023 13:31:37 +0800
Subject: [PATCH] Refining Ch03.

---
 src/programming_concepts/comments.md | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/src/programming_concepts/comments.md b/src/programming_concepts/comments.md
index a15dceb..8c4d0b0 100644
--- a/src/programming_concepts/comments.md
+++ b/src/programming_concepts/comments.md
@@ -1,20 +1,29 @@
 # 注释
 
-所有程序员都会致力于让他们的代码易于理解，而有时是需要额外解释的。在这种情况下，程序员们就会在他们的源代码中，留下会被编译器忽略的 *注释（comments）*，而那些阅读到源代码的人会发现有用。
+**Comments**
+
+
+所有程序员都努力使自己的代码易于理解，但有时也需要一些额外的解释。在这种情况下，程序员会在源代码中留下 *注释，comments*，编译器会忽略这些注释，但阅读源代码的人可能会发现有用。
 
 下面就是个简单的注释：
 
 ```rust
 // hello, world
 ```
-在 Rust 中，惯用的注释风格，是以双斜杠来开始一条注释，同时该注释会持续到那行的结束。对于那些超过一行的注释，在每行注释就都要包含 `//`，就像这样：
+
+
+在 Rust 中，惯用的注释风格，以两个斜线开始一条注释，而该注释会一直持续到行尾。对于超出单个行的注释，咱们需要在每一行，都包含 `//`，像下面这样：
+
 
 ```rust
-// 那么这里要编写一些复杂的注释，这注释长到要用多个行
-// 才能写完！噢！还好，这条注释会解释接下来要做些什么。
+// 所以我们要做的事情很复杂，长到我们需要
+// 多行注释来完成！呼！希望这条注释能
+// 解释发生了什么。
 ```
 
-注释也可以放在那些包含代码行的末尾：
+
+注释也可以放在包含了代码行的末尾：
+
 
 文件名：`src/main.rs`
 
@@ -24,7 +33,8 @@ fn main() {
 }
 ```
 
-不过更常见的则是以下面这种形式运用的注释，其中注释位处单独的、在其要注解代码之上的行：
+但咱们更经常看到的是，将注释放在其所注释代码上方单独一行，这种形式：
+
 
 文件名：`src/main.rs`
 
@@ -35,4 +45,4 @@ fn main() {
 }
 ```
 
-Rust 还有另外一种注释，叫做文档注释，在第 14 章的 [将代码箱发布到 Crates.io](Ch14_More_about_Cargo_and_Crates.io.md#将代码箱发布到-cratesio) 中会对文档注释进行讨论。
+Rust 还有另一种注释，即文档注释，documentation comments，我们将在第 14 章 [“将 Crate 发布到 Crates.io”](../crates-io/publishing.md) 一节中讨论。