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

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

注意他们所说的话是有道理的，因为：

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

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

  
  

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

将您的文本分成段落

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

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

使用一些可用的样式

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

• 大胆的。

• 斜体。

• 标题。

• 下划线，或

• 删除线

  
  

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

让读者轻松

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

• 使用 HTML 链接，以及

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

  
  

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

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

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

阅读和编辑你写的东西

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

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

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

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

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

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

  
  

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

  
  

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

  
  

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

语法

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

优点：

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

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

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

  
  

缺点

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

语言工具

优点：

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

缺点：

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

成为读者最好的朋友

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

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

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

以前在这里发布。