我不是英语专业出身,但我作为一个作家,阅读了大量的教育(主要是技术)写作,我注意到有一些词语和短语经常出现,但对写作没有任何帮助。 事实上,它们可能会损害写作效果。
这最初是 Twitter 讨论,所以我认为我应该更清晰地写出来。
以下是一些这样的词语
1. 显然
现在子元素已经浮动,显然父元素将会坍塌,我们必须处理这个问题。
这可能是最常见的错误。 并非所有事情都像你认为的那样显而易见。 你说它应该是这样的,可能会让我在脆弱的时候感觉特别愚蠢。 而且如果对我来说很明显呢? 这个词对我没有帮助。 省略这个词,句子通常会更好。
2. 基本上
基本上,你只需要绑定单击事件,并在触发时调用函数。
你可能可以用更少的词语,并更清楚地解释它。 另一个例子是省略这个词,句子通常会更强。
3. 简单
只需在路由器中添加一条指向新控制器的路线。
这可能很简单,但省略这个词读起来会更好。 这是一个指令,它不需要任何修饰。
4. 当然
当然,视网膜图像对于非视网膜屏幕来说太大了。
你应该用文字或图表来清楚地解释原因,而不是仅仅告诉我某些东西应该是显而易见的,而对我来说可能并非如此。
5. 清楚
显然,该函数返回另一个函数。
如果真的那么清楚,你就不需要告诉我它有多清楚。
6. 只是
只需打开你选择的矢量编辑程序,然后更改颜色即可。
在这种情况下,只是这个词是一个附加词,让它显得更随意。 比添加词语,有更好的方式变得随意。
7. 人人都知道
更多千字节意味着加载时间更长。 人人都知道这是一件坏事。
如果我不知道这一点,我就会立即感到疏离,并开始认为我读错了东西。 你可以想象诸如“众所周知”之类的变体。
8. 然而
但是,要注意你使用的库数量。
然而这个词有一些有用的用法,但用它开始新的句子或文本部分可能会成为一个无用的过渡词。
9. 所以
所以,如果你有兴趣,请与我联系!
这样使用,所以是一个过渡词,用来将前面的句子与结尾部分隔开。 这里可能需要一个没有额外词语的新段落。
10. 简单
更改 X 和 Y 坐标,将元素移动到新的位置。 简单。
这是试图让人放心并显得随意,但如果原本应该简单的事情对读者来说并不那么容易,就会让人沮丧。
我是一个违规者
我相信这些词语有很多很好的用法。 语言不像“这些词语好,这些词语坏”那样简单。 这是一种细致入微的事情。 在教育写作中,清晰直接是宝贵的,也是值得赞赏的。 省略填充词,并将随意的氛围留到你不试图解释复杂事物的时候。
我相信我在这整个网站上都使用过这些词语,并且以其他方式写错了句子。 请随时 指出我的错误。 我很乐意重新审视文章,使其变得更好,尤其是在某些内容不清楚的情况下。
有点偏题,但这是一个非常友好的提醒。 新鲜和建设性是最好的。
作为一名英语专业毕业生和现任专业作家,我 100% 同意你的观点。 我想补充一点,就是使用大词而不是小词,例如使用“利用”而不是“使用”。 我编辑过很多技术文档,它们坚持使用“利用”,而“使用”就足够了。 这只是一个使用大词而不使用小词的例子。 大词让我们感觉自己很聪明,但小词让我们的写作更容易阅读,因此在读者眼中我们看起来更聪明。 这是一个更好的目标!
但这是一个很好的提醒,即使是对我们(我)这些每天都使用文字和写作的人来说也是如此。 哦,我们有多少坏习惯!
Rich,
你触及了我最讨厌的一点——利用! 为什么每个人都要选择这个词,而使用更好? 还有“我自己”而不是“我”,这让我头疼。
感谢你的提醒,Chris!
显然,作为一名老师,我应该在本学期录制我的课程,这样我就可以看看自己是否说了任何这些词语。 很明显,我只需要用我的 iPhone 或 iPad 拍摄视频。 简单。 然而,我可以让我的学生通过给他们一份“我不应该说的词语”列表来记录,并在我说出这些词语时让他们打勾。 简单! 当然,他们可能会错过我说出很多我不应该说的一两个词语——因为人人都知道我让我的学生着迷并吸引了他们的注意力。 所以,我可能还是自己做比较好。
显然,没有人应该使用这样的词语。当然,它们不会给句子增添任何东西。简而言之,这些东西是胡说八道,很明显。每个人都知道这样打字是多么愚蠢。然而,这一点并不为人所知。他们是如何打出这些词语的?很简单。他们就像我们一样,只需按下键盘上的相应按键,对吧?
看看上面的段落,再看看上面的句子。
说真的,有人理解我!青少年经常添加其他东西,
例如:他很惊讶!
完全:这些东西完全很烂!
好吧:你这样做,好吧?
还有很多。我忘记了。
不错,但你漏掉了什么——这些词语在学校的英语作业中非常有用——它可以帮助非正式的信件轻松达到所需的字数。 ;)
别忘了梅林·曼最喜欢的,“结果是”。相反,解释一下为什么得出这个结论。
感谢你的文章。我是一名文案转行成为开发人员。在学习过程中,我经常会想到,许多我从中学到知识的博客和书籍都热衷于倡导我们在设计决策中“以用户为中心”,却完全忽视了真正阅读他们作品的人。
这个问题的另一个表现形式是文档质量差。令我百思不得其解的是,有人可以开发出一个插件或工具来节省其他开发人员的编码时间,却提供一个写得很差的自述文件,让新用户花费大量时间和精力才能理解它的用途并开始使用它。
我并没有真正为此感到沮丧。我感谢许多作者,他们在这篇文章(以及其他以读者为中心的写作原则)中犯了最严重的错误。但我很高兴你正在解决这个问题,克里斯。我认为低质量的教育性写作可能会阻碍网络社区的发展,如果我们不小心的话。
维克多·雨果:“抱歉,我没有时间把它(这封信)写得更短”。
对这个主题/主题的很好总结。
我想提名“话虽如此”作为第 11 个。
我会将“实际上”添加到那些不会给句子带来任何益处的词语列表中。借用你对“基本上”一词的例子,
当作者想强调他们正在说明的观点时,这个词往往被误用,而不是它原本的含义——澄清与比喻相反的含义。对于上面的句子,这句话也同样适用,
这不是什么大事,但它总是让我感到这个词既被过度使用又被误用。
谢谢!对非英语母语的作者很有用。我会注意我的文章,避免使用这些词语。
我也属于这种情况。当我写操作指南时,我知道我的读者专业知识水平会有所不同,从新手到专家,我记得我依赖这些词语,以免让那些觉得自己是专家的人感到疏远。这并不是过度使用这些词语的充分理由,但我记得在这样做时,我的脑海里闪过这些想法。
“你可能可以用更少的词语”。
我想你的意思是“你可能可以用更少的词语”。因为在教你如何写作的文章中,你知道……
谢谢亚当。我之前没有意识到这个区别。我已经更新了。对于感兴趣的其他人,这里有一篇关于这个主题的博客文章:http://www.quickanddirtytips.com/education/grammar/less-versus-fewer
这个属于“使用 ID 或类”的范畴。我们从那段舞蹈中学到的教训是:不必对此过于教条主义。
抱歉,我没有看到这里学到的教训。
几周前我看到了一些关于这个主题的推文——很高兴看到一篇完整的文章!读起来很不错。很有道理——如果你想教别人一些东西,你不应该把你的任何教学内容都当作容易或明显的东西。它很容易阻止潜在的读者尝试你所教的内容。
感谢你的文章!
基本同意,我也是罪魁祸首之一。
但有时也有一些理由使用这些词语。在教学过程中,重要的是以一种平易近人的方式进行,避免让读者感觉他们在阅读一本呆板的技术手册。一些词语可以用来使文章或教程更自然、更口语化。
但我自己的建议是,我会避免使用以下词语
真的
非常
我经常在我的文章中搜索这两个词并删除它们。这样做很少会改变什么,还能让文章更清晰。你不需要说
opacity
属性真的具有很好的浏览器支持,你可以直接说它具有很好的浏览器支持,或者更进一步,告诉我们浏览器支持情况。这与你在文章中讨论的关于其他词语的观点类似。好文章,但我几乎都用过这些词语,我个人认为它们确实很有用。
显然,这是一个主观问题,但我感觉添加这些小词语可以帮助文本更流畅。
当然,我也可能只是一个不够优秀的作家。所以我可能只是在依赖它们作为拐杖?
无论如何,每个人都知道,在写作方面,一个情况下有效的方法在另一个情况下可能无效。显然,这一切都取决于具体情况。
+1
确实如此。
同意,这确实取决于具体情况,在这种情况下,具体情况是在文章中提供的:专门针对网站开发等技术主题的教育类文章。
有趣!
然而,:-)
只要内容值得阅读,我作为非英语母语人士在阅读文本时并不太在意这些问题。
此致
作为非英语母语人士,以及从零开始学习英语三年的人,我确实很在意。 ;)
事实上,很大一部分技术文档都是用英语写的,而查找信息,至少是关于 web 开发的信息,最快的途径是用英语,所以文档写得越清晰、越一致,没有令人分心的词语或概念,我认为沟通就越有效。
顺便说一下,感谢你的文章!
你可以添加“利用”,这是互联网上使用过度且使用不当的词语。
1 利用
这是互联网上使用不当的头号词语。作者使用“利用”来代替“使用”。为什么?我想他们认为这听起来更聪明。几乎在所有我看到这个词的地方,作者都应该使用“使用”这个词。
“利用”是指将某物用于非预期目的。例如,“我们将使用那台旧 Mac 作为门挡”。
错误:我可以利用你的电脑发送电子邮件吗?
正确:我可以使用你的电脑发送电子邮件吗?
这里有一个简单的规则,这样你就会知道什么时候使用“利用”:永远不要使用。
这并不完全正确。这种用法主要针对美国人。“利用”还有其他几种含义 ,包括“充分利用”。
但正如你所说,它往往被用来炫耀,而不是有用。“使用”通常更好。
我感觉许多作者在刚开始写作时都会经历一个严格的阶段(我经历过!)。虽然在写作中保持纪律是好事,但要小心过度热情!对自己的正确性过于自豪会使你对写作中其他问题视而不见——比如枯燥乏味。
这就像程序员执着于如何格式化括号和空格,或者是否使用单引号还是双引号。你会迷失在细节中,擅长细节会成为你抵御批评的盾牌。你会因为你的写作没有技术缺陷而感到自豪。这不是一种有效的心态。当你写出引人入胜的东西时,你才会为你的写作感到自豪。
我认为 Chris 在此处的写作就是一个很好的例子。它很清晰,但他不会因为过分担心让一切都“完美”地符合规范而偏离主题。他还以一种非正式、友好的语气进行写作,并没有用太多词语来夸大文章。他的写作中体现了他的个性(谦逊、善良、支持、诚实、直率)。
写作是关于交流的。用更少的词语可以使交流更加清晰;但如果过分使用它,你的写作可能会变得支离破碎——就像一棵树被修剪得太厉害而枯萎了。
很好的提醒。不过,我对第8点有些异议。我认为它可以作为简洁的过渡,或者是对通常隐藏在简单说明背后的复杂问题的介绍或提示。
但是,我不会坚持你一定要使用它。
我将开始在 StackOverflow 上链接到这篇文章,哈哈!在技术主题的写作中,作者应该始终意识到来自所有经验水平的读者都会看到他们的作品,编程社区应该包容,而不是排斥。
Chris,当你写一些你可能已经写过几十遍但还没有理解的主题时,你非常擅长**不**让我感到愚蠢。
这些词语非常适合需要写一定字数的论文写作。
我不禁注意到列表中的前三项都是副词,它们通常是我们在试图简洁地阐述观点时应该避免的。它们用于强调,但通常会产生相反的效果:它们因为多余而削弱了观点。经验法则:无情地消灭它们。
mercilessly.我还会说,列表中的8/10个词语会在我们没有设身处地地站在读者的角度去理解他们的专业水平时出现在我们的写作中。如果我们假设读者拥有与我们相同的技能水平,而实际上并非如此(否则,为什么要写这些作品呢?),像“显然”或“容易”这样的词语会让人觉得自命不凡和居高临下。它们会赞美那些可以快速理解概念的同等水平或比我们水平更高的人(在技能方面),而贬低那些正在努力达到我们水平的人。
我在这里就像其他人一样犯错,我正在努力控制自己。为此,我做了一些类似于 Stephen King 在《写作之道》中建议的事情:在校对之前让你的草稿休息一段时间。我已经养成习惯,保存电子邮件、文章甚至推文的草稿,并在几个小时或几天后以全新的视角重新审视它们,以确保我发送给受众的语气和信息是正确的。
很棒的文章。
Jesse。史蒂芬·金给出的建议很好。我还会大声朗读文章。这是一种很好的方法,可以发现眼睛无法发现的错误。
在很多方面,这确实适用于对话、电子邮件以及任何公开的交流。
另一个例子是短语“为了”。例如:“为了优化你的网站……”。
写“优化你的网站……”,简洁明了。
基本上,简单地说,只是,所以,容易,哎呀……
我使用这些词语是因为我的英语水平有限。抱歉……
面对面的课程和录制课程更具挑战性。这些词语必须发自内心。我听到过这些,真的:“你奶奶都能做到。”或者“这不是你妹妹能建的网站。”这对任何人来说有什么帮助,无论男女。
很好的建议,谢谢!在写作中很容易使用这些词语,尤其是对于非英语母语的作者来说。从现在开始要留意这些词语。
这让我想起了我的大学数学书,它经常省略定理的证明,因为它们太简单了。而对于我来说,它们可一点也不简单…
数学有它自己的语言。
当一个专家可以在几页纸内证明一个问题(依赖于其他几个定理)时,这个问题就是“简单的”。
当一个优秀的数学家需要花一个月时间才能理解一个问题时,这个问题就是“不简单的”。
当世界上只有三个人理解一个问题时,这个问题就是“非常不简单的”。
当证明一个问题需要天才般的洞察力或大量的计算,或者两者兼而有之,这个问题就是“极其不简单的”。
当没有人知道一个问题是否可以被证明,并且他们已经尝试了至少一百年,这个问题就是“具有挑战性的”。
我们是在谈论技术写作还是一般的写作?
将“个人”添加到列表中;例如,我个人认为…
相反,使用“我认为…”,或者更好的是,直接写出你的想法。读者足够聪明,可以理解你写的就是你的想法。
自从我因为在解释如何做某件事时使用“只是”而受到批评(对方觉得我是在居高临下)之后,我一直努力在指导或培训他人的时候不使用它。谢谢您提供其他词语,我偶尔也会犯一些这样的错误!
这对我们这些每天都使用词语和写作的人(我)来说是一个很好的提醒。哦,我们有很多不好的习惯,比如“显然”、“基本上”和“只是”。
Chris,很好的建议。我的叔叔喜欢讲他流体力学教授的故事,他很喜欢说,“…这对于最随便的观察者来说是显而易见的……”,好像流体力学中的任何事情都属于这一类。
为什么我觉得这些词语在这里很棒?虽然我不是英语母语人士。
我完全同意。
我一直都在用这些词语 :P
我的每一篇文章里至少有一个。
我会努力改进,谢谢您的建议。:)
我很感谢像这样的偶尔的帖子,它们有点偏离主题,但对社区仍然有用。写得好。(这条评论读起来像垃圾邮件,但我确实是认真的!)好吧,我停下来了。现在就停下来。
我的心头之恨:“事实上”。
在“容易”旁边,我会加上“简单”。我读过不少文档,用这些词语来掩盖“复杂”的过程。
Chris,写得很好。作为一名拥有英语专业教育学位的设计师,这与我的内心想法很契合。所有这些词语最大的相似之处在于:它们都假定理解(如果不小心,还会让人觉得有点居高临下)。通常情况下,假定理解,而不是解释它,会很危险。
我明白,你不可能解释每一个小细节,否则你会创造出《世界指南》。这可能需要花费很多时间才能完成。
谢谢您分享,Chris。我写了一个简单的正则表达式,您可以用它在您选择的工具(比如 Sublime Text 的搜索工具)中突出显示这些词语。我还添加了 Craig Patik 在上面的评论中提到的短语,因为我认为它也很有效。