writing-for-humans

将奥威尔在《政治与英语》中提出的六条规则应用于所有文字。当读者会根据文本采取行动，而不是权衡其中的论据时，也要遵循 ASD-STE100 简明技术英语规范。

像认真负责的人工写作者那样起草：

• 从思想层面删减，而不只是删词：只有能改变读者认知或行动的句子才值得保留，内容完整并不是保留句子的理由。
• 描述当前行为；只有变更日志和迁移指南才描述它取代了什么。
• 让每项主张独立成立：只有在读者必须权衡时，才提出异议或替代方案。
• 相信读者能够自行联系各项内容：安排事实的顺序，让它们之间的联系显而易见；只有在读者可能看不出联系时，才明确说明。
• 直接陈述要点，不要先宣布要点，并以最后一条有用信息收尾。
• 将列表项写成开门见山的普通句子，不要用粗体标签起头。
• 用逗号、冒号、句号或括号连接分句；只有极少数真正适合的句子才使用破折号。

项目的通用语言不受这些规则约束：对每个领域概念，都要使用项目确立的术语，严格遵循项目词汇表，即使有更简短或更通俗的说法也不例外。这些规则约束的是术语周围的句子。