# 审核者须知

参考技能文档的[编写者须知](https://docs.net9.org/notes/editor/)，除此之外：

1. 将翻译稿中出现的类似于“书中第 xx 章”的字样删去。
2. 所以示例代码必须自己完全运行，避免因为 API 过于老旧无法使用。

------

# 重要事项

**正确使用标点符号**

+ 正确使用**全角**标点符号与**半角**标点符号。汉语请使用全角符号，英语请使用半角符号。
+ 请在每句话的末尾添加**句号**。
+ 正确使用**括号**。括号在句中表示对句中前一个元素的解释说明，如 `语法糖（英语：Syntactic sugar）`。括号在句外表示对前面整个句子的解释说明。
+ 正确使用**分号**，可以使得行文结构更加清晰。

**正确进行中文排版**

+ **中英文之间、中文和数字之间需要增加空格，数字和单位之间不需要增加空格。**
+ 行文中正文与超链接之间需要增加空格。
+ 全角字符和其他字符之间不加空格。
+ **专有名词使用正确的大小写。如使用缩写，则该缩写应已成为业界标准。**

**推荐的代码风格**

+ 变量使用驼峰命名法、下划线命名法等均可，但需要尽量保证同一篇文档内命名风格统一。
+ 下列代码风格惯例以 C++ 语言为例：
    + 大括号换行与不换行均可，但需要保证同一篇文档内格式统一。不换行时，其与左侧的右括号之间应当有一个空格。
    + 关键字 `if`、`for` 等与后续左括号之间应当有一个空格。
    + 运算符 `+`、`-` 等与左右操作数之间应当各有一个空格，运算符 `.`、`->` 两侧均不应当有空格，逗号 `,` 左侧不应当有空格而右侧应当有空格。
    + 行内注释起始标记 `//` 与注释文字间应当有一个空格。
    + 使用 2 个空格或者 4 个空格进行缩进均可，但需要保证同一篇文档内统一。