拼写

中文技术文档既包含中文内容,也可能包含英文内容,因此应严格避免以下几种拼写错误。

  • 简体中文和繁体中文不能混用。

  • 禁止出现中英文错别字。错别字包括错字和别字,两者均不能出现。

    • 错字是将某个字写错,这个错字是人为编造出来的,无任何意义。如将 MySQL 写成 MySOL。

    • 别字是指写出的字与正确的字形近或音近,但意思却不同。如将 cooperate 写成 corporate,将 authorization 写成 authentication。

英文的大小写形式

  • 英文大小写形式不能写错。如不能写成 mysql 数据库,应该写成 MySQL 数据库,具体参考名称使用一节。

  • 当中文句子中夹有英文单词或词组时,无论该英文单词或词组位于中文句子的开头、中间还是末尾,普通单词、词组必须小写专有名词等在英文中必须大写的单词或词组,保留其大写形式

    • 【示例一】change 和 transform 意义不同。

    • 【示例二】这个数据库有不错的 MySQL 兼容性。

  • 当中文句子中夹有完整的英文句子时,无论该英文句子位于中文句子的开头、中间还是末尾,其首字母均保留大写形式

    • 【示例一】Follow your fear 是我的座右铭。

    • 【示例二】他经常与人说“Never set a limit to yourself.”。