6、技术写作风格与在线文档写作指南

技术写作风格与在线文档写作指南

1. 避免冒犯读者的写作风格

在写作过程中，风格的考量不应仅仅停留在个人偏好层面，还需注意可能冒犯读者的写作风格。以下几种情况需要特别留意：
-避免幽默：在计算机文档写作中，作者很容易想在文本中加入幽默元素，但应抵制这种诱惑。即使是真正幽默的评论，也会分散读者的注意力，再次阅读时还会令人厌烦。而且幽默往往具有文化性，对美国人来说有趣的内容，可能会冒犯其他国家的读者。
-示例：原句 “You can use a mouse (one without fur) in conjunction with the window system of your computer.” 中 “one without fur” 分散了读者注意力，句子本意是告知鼠标与窗口系统的关系。
-改写：“The mouse is a versatile tool that you use with the window system of your computer.”
-避免性别歧视语言：在语言使用上，性别歧视问题不容忽视。过去 “men” 常指 “男人和女人”，“he”、“him” 和 “his” 被视为中性词汇，但如今这种用法已不太被接受，因为这些代词过度预设了个体的性别。
-实现通用性别表达的可接受方法：
-使用复数先行词和复数代词：如 “Tell each user to shut down his m