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