技术写作或技术交流是关于向普通受众传递技术信息。 在技术文档中使用通俗易懂的语言可以使文章清晰，简洁并且对读者有所帮助。
通俗易懂的语言写作可以帮助目标受众轻松理解信息，避免误解并节省时间，因为它可以使工作第一次完成。
定义简单的语言
悉尼大学前现代英语语言副教授罗伯特·伊格森（Robert Eagleson）教授将通俗语言描述如下：
- 朴素的语言是清晰，直接的表达方式，仅使用必要的单词；
- 这种语言避免了晦涩难懂，夸张的词汇和复杂的句子结构；
- 这不是在谈论婴儿，也不是英语的简化版。
- 普通英语的作家让他们的听众专注于信息，而不是被复杂的语言所分散；
- 他们确保听众容易理解消息。
通俗易懂的语言是在使目标受众首次阅读时可以理解并采取行动。
法律写作是技术写作的一种。 它的显着特征包括语法过于复杂和过于形式化的趋势。 比较以下示例，以了解使用简单语言编写的思想。
前两段包含对读者来说不必要的多余信息，只有最后一段暗示了消息的目的。 此外，整封信以过分正式的方式写着，句子冗长，不常见的单词和陈词滥调，难以阅读。
让我们看看简单的语言是否可以改善本文。
官方消息包含153个单词，而普通语言版本仅使用77个单词。两种消息均分为3个段落，即3个想法，在第二个版本中对其进行了仔细地保留。 同样明显的是，第二条消息更易于阅读和浏览。 所有这些好处都是通过通俗易懂的语言实现的。
编写简单的语言
Microsoft样式手册提供了以下建议：“使用简单的句子和简短的单词。 使用用户使用并可能与之相关的关键字。 例如，他们想要“下载”，而不是“体验最新的创新”。还要避免用户可能不理解也不会搜索的技术术语和行话。
这些是简单书写的快速提示，显然还不够。 这就是为什么我们要编制自己的11个普通写作技巧列表的原因。
普通写作技巧
- 首先要把重要的信息放在首位；
- 写简短的句子（平均15-25个单词）；
- 一句话-一个主意；
- 改变节奏（考虑两个或三个单词的简短句子）；
- 将文本分成小块（一个段落-一个想法）；
- 避免用动词造名词（名词化）；
- 避免行话。 如有可能，请更换它-如有必要，请问问自己。 如果必须使用技术术语或专业术语，请在首次看到它时说明其含义；
- 避免长话。 使用更常用的词，即使用而不是利用；
- 避免使用缩写词。 如果潜在的首字母缩写词在单个段落中出现了三次或多次，则可以使用它。 确保在读者可能会加入的每一个方面都对它进行解释；
- 删掉多余的单词；
- 使用主动语音。
现在轮到你了
请记住，文档应该易于阅读。 经济地使用目标受众可以理解的单词。 另外，请确保句子结构紧凑且外观设计美观。
祝您技术上写好运！
ClickHelp小组
跨平台和设备编写，托管和交付文档
