news 2026/6/10 21:04:02

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 12:29:50

9、编写有效程序步骤的全面指南

编写有效程序步骤的全面指南 在编写各类文档时,程序步骤的编写至关重要,它直接影响到读者是否能够准确、高效地按照说明完成任务。下面将详细介绍编写有效程序和步骤的方法与准则。 编写有效程序的准则 编写有效程序需要遵循一系列准则,以确保程序易于理解和执行。具体准…

作者头像 李华
网站建设 2026/6/10 12:14:57

初学HTML2

1.HTML的特点简易性HTML语言比较简单,使用操作方便,灵活方便可扩展性HTML目前有着广泛的应用,并且增加了标识符等要求平台无关性HTML可以使用在广泛的平台上,这也是万维网盛行的另一个原因通用性HTML是一种通用的语言,…

作者头像 李华
网站建设 2026/6/10 14:32:25

AI写论文工具排行榜:9个优选方案,覆盖开题到终稿全流程

在毕业论文季,高效完成开题报告和论文是很多学子的痛点。人工写作虽然灵活,但耗时耗力;而AI工具的兴起,能快速生成内容、优化重复率和AI痕迹。今天,我通过9款平台对比,帮你找出最适合的“学术搭档”。先从人…

作者头像 李华
网站建设 2026/6/10 11:33:01

16、网络写作、术语表与索引指南

网络写作、术语表与索引指南 1. 网络写作术语规范 在进行网络相关内容写作时,使用准确规范的术语至关重要。以下是一些常用的网络术语使用准则: - 通用浏览器表述 :当泛指网络浏览器或主浏览器窗口时,使用 “web browser” ,而非 “web browser window” 或 “browse…

作者头像 李华
网站建设 2026/6/9 18:06:49

11、技术出版中的法律准则:版权与商标的保护与使用

技术出版中的法律准则:版权与商标的保护与使用 在技术出版领域,专业人员需要严格遵循一系列法律准则,这些准则涵盖了商标的正确使用与标注,以及知识产权的保护等重要方面。商标、版权作品和商业秘密是公司最宝贵的资产之一,任何参与使用商标材料准备或创作受版权保护作品…

作者头像 李华
网站建设 2026/6/10 5:09:37

21、技术文档写作实用指南

技术文档写作实用指南 1. 常见表单和清单 在技术文档的创作和管理过程中,有一些常见的表单和清单能帮助我们更高效地完成工作。以下是一些常见的表单和清单: - 手稿跟踪表 :用于记录手稿的状态和进度。 - 编辑请求表 :向编辑人员提出编辑需求。 - 插图请求表 :…

作者头像 李华