news 2026/1/14 8:31:58

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/1/10 4:19:21

学术作品相似度过高?五个专业技巧帮你突破合格门槛

论文重复率超30%?5个降重技巧,一次降到合格线 嘿,大家好!我是AI菌。今天咱们来聊聊一个让无数学生头疼的问题:论文重复率飙到30%以上怎么办?别慌,我这就分享5个实用降重技巧,帮你一次…

作者头像 李华
网站建设 2026/1/11 2:51:56

汇编语言全接触-24.WINDOWS钩子函数

本课中我们将要学习WINDOWS钩子函数的使用方法。WINDOWS钩子函数的功能非常强大,有了它您可以探测其它进程并且改变其它进程的行为。 理论:WINDOWS的钩子函数可以认为是WINDOWS的主要特性之一。利用它们,您可以捕捉您自己进程或其它进程发生的…

作者头像 李华
网站建设 2026/1/9 6:46:37

接口中的方法全解析(JDK8-17 演进 + 实战示例)

在之前讲抽象类和接口区别时,我们只提了接口方法的 “大类”,但接口的方法类型远不止 “抽象方法”—— 随着 JDK 版本迭代,接口支持的方法类型越来越丰富,不同方法的定位、用法和注意事项差异极大。今天专门补充接口中所有方法类型的细节,帮你彻底吃透接口方法的设计逻辑…

作者头像 李华
网站建设 2026/1/6 19:38:47

OAuth2 协议解析(安全视角)

RefinitionOAuth2 是在WEB基础上发展出来的一个授权框架(Authorization Framework),也可以认为它是一套协议,一套能解决第三方授权问题的解决方案,优势在于它允许第三方应用在不获取用户密码的情况下,获得访…

作者头像 李华
网站建设 2025/12/22 21:08:23

xv6与opensbi的定时器中断

在实现了第一个系统调用myHelloWorld、虚存管理后,为了实现能够做到分时系统的进程管理,我们需要启用定时器中断。 寄存器 为了实现定时器中断,你需要知道(牢记)如下寄存器,这些寄存器是你在处理定时器中断时特别关心的。 scau…

作者头像 李华
网站建设 2025/12/13 18:58:20

Code Surfer终极指南:让代码演示生动起来的完整教程

Code Surfer终极指南&#xff1a;让代码演示生动起来的完整教程 【免费下载链接】code-surfer Rad code slides <&#x1f3c4;/> 项目地址: https://gitcode.com/gh_mirrors/co/code-surfer 还在为枯燥的代码演示而烦恼吗&#xff1f;&#x1f914; 想要让你的技…

作者头像 李华