Skip to content

Commit

Permalink
docs(text): add style rule
Browse files Browse the repository at this point in the history
  • Loading branch information
ruanyf committed Jun 12, 2018
1 parent 37ab027 commit ff59d51
Showing 1 changed file with 16 additions and 8 deletions.
24 changes: 16 additions & 8 deletions docs/text.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,23 +43,31 @@

## 写作风格

尽量不使用被动语态,改为使用主动语态。
1、尽量不使用被动语态,改为使用主动语态。

```
错误:假如此软件尚未被安装,
正确:假如尚未安装这个软件,
```

不使用非正式的语言风格。
2、不使用非正式的语言风格。

```
错误:Lady Gaga 的演唱会真是酷毙了,从没看过这么给力的表演!!!
正确:无法参加本次活动,我深感遗憾。
```

用对“的”、“地”、“得”。
3、不使用冷僻、生造或者文言文的词语,而要使用现代汉语的常用表达方式。

```
错误:这是唯二的快速启动的方法。
正确:这是仅有的两种快速启动的方法。
```

4、用对“的”、“地”、“得”。

```
她露出了开心的笑容。
Expand All @@ -72,39 +80,39 @@
(动词+得+副词)
```

使用代词时(比如“其”、“该”、“此”、“这”等词),必须明确指代的内容,保证只有一个含义。
5、使用代词时(比如“其”、“该”、“此”、“这”等词),必须明确指代的内容,保证只有一个含义。

```
错误:从管理系统可以监视中继系统和受其直接控制的分配系统。
正确:从管理系统可以监视两个系统:中继系统和受中继系统直接控制的分配系统。
```

名词前不要使用过多的形容词。
6、名词前不要使用过多的形容词。

```
错误:此设备的使用必须在接受过本公司举办的正式的设备培训的技师的指导下进行。
正确:此设备必须在技师的指导下使用,且指导技师必须接受过由本公司举办的正式设备培训。
```

不包含任何标点符号的单个句子,或者以逗号分隔的句子构件,长度尽量保持在 20 个字以内;20~29 个字的句子,可以接受;30~39 个字的句子,语义必须明确,才能接受;多于 40 个字的句子,在任何情况下都不能接受。
7、不包含任何标点符号的单个句子,或者以逗号分隔的句子构件,长度尽量保持在 20 个字以内;20~29 个字的句子,可以接受;30~39 个字的句子,语义必须明确,才能接受;多于 40 个字的句子,在任何情况下都不能接受。

```
错误:本产品适用于从由一台服务器进行动作控制的单一节点结构到由多台服务器进行动作控制的并行处理程序结构等多种体系结构。
正确:本产品适用于多种体系结构。无论是由一台服务器(单一节点结构),还是由多台服务器(并行处理结构)进行动作控制,均可以使用本产品。
```

同样一个意思,尽量使用肯定句表达,不使用否定句表达。
8、同样一个意思,尽量使用肯定句表达,不使用否定句表达。

```
错误:请确认没有接通装置的电源。
正确:请确认装置的电源已关闭。
```

避免使用双重否定句。
9、避免使用双重否定句。

```
错误:没有删除权限的用户,不能删除此文件。
Expand Down

0 comments on commit ff59d51

Please sign in to comment.