“词语是有意义的”是我最喜欢的表达之一。我经常在玩笑中使用它，但在编写文档时，这是一个重要的考虑因素。我通常是一个喜欢用艺术天赋来运用文字的人，但是当涉及到编写技术文档时，我在措辞上变得更加谨慎。我不知道这种习惯是什么时候开始的，但我注意到多年来，我在如何使用词语方面变得越来越小心。本文介绍了您在写作时可以牢记的三个注意事项和随附的资源。
技术娴熟的作者习惯于像他们技术娴熟一样写作。不幸的是，读者并不总是那么精通，特别是当他们是项目新手时。最好使用简单、明确的术语，并解释新的或特定于主题的术语。IEEE 专业传播协会在清晰的措辞选择方面提供了出色的指导。
以从未用过电脑的人为例。习惯“点击”涉及鼠标（或触控板），而“按下”涉及键盘的想法可能需要一段时间才能适应。如果文档开始交替使用这些术语，读者可能会感到困惑。经验更丰富的读者可以从上下文中找出正确的操作，但是对于刚开始学习计算机基本知识的人来说，这种不一致性可能会让人感到不舒服。
正确的措辞还有另一个优势：读者花在弄清楚你的意思上的时间越少，他们花在你想表达的内容上的时间就越多。如果您的文档具有一致的用词，并且其他人的用词也一致，那么您的读者的生活就会变得更好。微软有一个全面的用户交互术语词汇表。
用词的一致性不仅对您的读者有帮助，对您的翻译人员也有帮助。字符串越一致，翻译工作就越少。
说到翻译，更简单的词语减少了翻译人员在找到正确的翻译之前必须查找单词的次数。坚持使用常用词语也有助于您以读者更可能理解的方式解释概念。XKCD 漫画《Up Goer Five》就是一个很好的例子。《牛津 3000™ 词汇表》是一个很棒的常用词汇表。当然，使用更简单的词语通常意味着使用更多的词语，因此简单和简洁常常是矛盾的。如果您了解您的受众，您可以达到适当的平衡。
所以请记住，当您写作时：要简洁、要一致、要简单。词语是有意义的。
7 条评论