paint-brush
我在编码中摇滚!但是我如何更好地语言?经过@marcinwosinek
1,869 讀數
1,869 讀數

我在编码中摇滚!但是我如何更好地语言?

经过 Marcin Wosinek2022/04/22
Read on Terminal Reader
Read this story w/o Javascript

太長; 讀書

最近,我有两个编程朋友向我指出了写作技巧的重要性。 注意他们所说的话是有道理的,因为: 一个人经营一家在线产品公司。 另一个在短短几年内从训练营毕业生跃升为首席开发人员。 让我们看一个简短的指南,以改善您在日常工作中的写作。 将您的文本分成段落 提高写作水平的第一步是将你的想法分解成易于理解的部分。当你的注意力从一件事转移到另一件事时,不要在句子之间留出一些空间,而不是倾倒一堵巨大的文字墙。 将内容分成段落将使您的文本更经济,更少压倒性并且更易于阅读。较小的块可以保留读者的精神能量。

Companies Mentioned

Mention Thumbnail
Mention Thumbnail

Coin Mentioned

Mention Thumbnail
featured image - 我在编码中摇滚!但是我如何更好地语言?
Marcin Wosinek HackerNoon profile picture


最近,我有两个编程朋友向我指出了写作技巧的重要性。


注意他们所说的话是有道理的,因为:


  • 一个人经营一家在线产品公司。

  • 另一个在短短几年内从训练营毕业生跃升为首席开发人员。


让我们看一个简短的指南,以改善您在日常工作中的写作。

将您的文本分成段落


提高写作水平的第一步是将你的想法分解成易于理解的部分。当你的注意力从一件事转移到另一件事时,不要在句子之间留出一些空间,而不是倾倒一堵巨大的文字墙。


将内容分成段落将使您的文本更经济,更少压倒性并且更易于阅读。较小的块可以保留读者的精神能量。

不要这样写。

使用一些可用的样式


您将发送消息的大多数系统都有一些可用的样式。您至少可以期望:


  • 大胆的。

  • 斜体。

  • 标题。

  • 下划线,或

  • 删除线


使用这些将使您的文本的快速解析更易于管理。您可以轻松地将读者的注意力引导到最重要的部分,从而更有可能实现所写文本的目标。

装饰有所作为。


让读者轻松

您可以做两件事来使读者的生活更轻松:


  • 使用 HTML 链接,以及

  • 在文本中包含图像以传达您的信息或解释问题


这些编辑选项并不总是可用。例如,在 Slack 中,我总是对无法在段落之间放置图像感到恼火。


当这些选项可用时,使用它们可以显着提高文本的可读性。图片在文字中被引用后可以立即看到,并且大量的链接不会破坏文字的流动。


这对于处理票证至关重要。例如,在 Jira 中,如果您只是在问题中添加一张图片,那么当您只有一张图片时仍然可以清楚地看到。但是,一旦团队在评论中添加了另外五张图片,它就会很快变得混乱。将图像放在文本中可以清楚地知道哪个是相关的。


网络自 1991 年以来就有链接,自 1992 年以来就有图像。让我们使用它们!

阅读和编辑你写的东西

稍加编辑可以大大改善文本的第一个版本。如果可以的话,最好保存草稿,稍后再回来编辑——也许在休息一段时间后,甚至第二天。


至少,在发布之前重读全文应该可以让你调整你说话的方式,以提高读者对你的文本的整体印象。


编辑是良好读者体验的关键。对于你写的大多数东西,你自己做应该足够好,这是对你的读者的基本礼貌。

图片说明


使用自动化工具来提高你的写作


字典检查并不是机器改进写作的唯一方法。如今,有一些先进的工具可以处理以下事情:


  • 捕捉在错误地方使用的拼写正确的单词(就像我一直使用“then”和“than”一样)。


  • 标记被动语态——使用主动语态可以让你的写作更加生动。


  • 重新组织句子以使其更易于阅读——至少根据算法。


如果你认真对待你的写作,你应该看看一些可用的应用程序。

语法

如果您收到类似的 YouTube 广告,您肯定听说过它们。自 2021 年 7 月以来,我一直在使用它,对此我很满意。这是我在博客上实施的第一次重大质量改进。


优点:


  • 它理解单词的上下文并相应地建议更改:它会告诉您您的意思是“它是”还是“它”。

  • 它指出了过度使用的单词并提出了其他选择。

  • 在付费版本中,它可以建议对句子进行重组。


缺点


  • 缺乏对英语以外的语言的支持。
  • Mac 上的 Firefox 插件与 Google Docs 有冲突。
  • 付费版本为 144 美元/年,比竞争对手高。
  • 您可以听到有关安全和隐私问题的信息。根据我的搜索,最严重的安全漏洞发生在 2018 年,他们很快修复了它。隐私问题与公司服务器上发生的所有处理有关,因此您需要相信公司会遵守其服务条款。

语言工具


优点:


  • 它支持更多语言(5种欧洲语言的语法校正),对20种语言的更基本支持等等
  • 您可以自行托管免费版本,因此您的数据完全由您控制


缺点:


  • 少营销——我只有在开始四处打听时才发现它们

图片说明


成为读者最好的朋友

所有这些提示都归结为考虑将阅读您的文本的人。你的工作是让他们更容易阅读。


它要求更加善解人意。付出额外的努力应该会给您带来丰厚的回报:通常,您的读者是您的老板或对您的职业有影响的人。


即使你为你的同事写作,很可能会有很多人——这对你建立高效沟通者的声誉很有帮助。


以前在这里发布。