技术写作风格与在线文档写作指南
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