paint-brush
私はコーディングでロック!しかし、どうすれば上手に言語を話せますか?@marcinwosinek
1,869 測定値
1,869 測定値

私はコーディングでロック!しかし、どうすれば上手に言語を話せますか?

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

長すぎる; 読むには

最近、2 人のプログラミングの友人から、ライティング スキルの重要性を指摘されました。 彼らの言うことに注意を払うのは理にかなっています。 1 つはオンライン製品会社を経営しています。 もう 1 人は、ブートキャンプの卒業生からわずか数年で主任開発者になりました。 日々の仕事でライティングを改善するための簡単なガイドを見てみましょう。 テキストを段落に分割する 文章を改善するための最初のステップは、考えを消化しやすい断片に分解することです。膨大なテキストの壁を捨てるのではなく、ある事柄から別の事柄に焦点を移す際に、文章の間にスペースを空けてください。 物事を段落に分割すると、テキストがより経済的になり、圧倒されず、読みやすくなります。チャンクが小さいほど、読者の精神的エネルギーが保持されます。

Companies Mentioned

Mention Thumbnail
Mention Thumbnail

Coin Mentioned

Mention Thumbnail
featured image - 私はコーディングでロック!しかし、どうすれば上手に言語を話せますか?
Marcin Wosinek HackerNoon profile picture


最近、2 人のプログラミングの友人から、ライティング スキルの重要性を指摘されました。


彼らの言うことに注意を払うのは理にかなっています。


  • 1 つはオンライン製品会社を経営しています。

  • もう 1 人は、ブートキャンプの卒業生からわずか数年で主任開発者になりました。


日々の仕事でライティングを改善するための簡単なガイドを見てみましょう。

テキストを段落に分割する


文章を改善するための最初のステップは、考えを消化しやすい断片に分解することです。膨大なテキストの壁を捨てるのではなく、ある事柄から別の事柄に焦点を移す際に、文章の間にスペースを空けてください。


物事を段落に分割すると、テキストがより経済的になり、圧倒されず、読みやすくなります。より小さなチャンクは、読者の精神的エネルギーを保持します。

このように書かないでください。

利用可能なスタイリングのいくつかを使用する


メッセージを送信するほとんどのシステムには、いくつかのスタイルが用意されています。少なくとも次のことが期待できます。


  • 大胆な。

  • 斜体。

  • ヘッダー。

  • アンダースコア、または

  • 取り消し線


これらを使用すると、テキストの迅速な解析がより管理しやすくなります。読者の注意を最も重要な部分に簡単に向けることができるため、書いているテキストの目標を達成する可能性が高くなります。

装飾は違いを生みます。


読者にとって使いやすいものにする

読者の生活を楽にするためにできることが 2 つあります。


  • HTML リンクを使用し、

  • メッセージを伝えたり、問題を説明したりするために、テキストに画像を含めます


これらの編集オプションは、常に利用できるわけではありません。たとえば、Slack では、段落の間に画像を挿入できないことにいつも悩まされています。


これらのオプションが使用可能な場合、それらを使用すると、テキストの読みやすさが大幅に向上します。テキストで参照された直後に写真を見ることができ、大量のリンクがテキストの流れを壊していません.


これは、チケットを扱う上で不可欠です。たとえば、Jira では、課題に画像を追加するだけで、そこに画像が 1 つしかない場合でも明確にすることができます。しかし、チームがコメントに他の 5 つの写真を追加するとすぐに、すぐに混乱する可能性があります。テキスト内に画像を入れることで、どれがどこに関連しているかが明確になります。


Web には 1991 年からリンクがあり、1992 年から画像があります。それらを使用しましょう。

あなたが書いたものを読んで編集する

少し編集するだけで、テキストの最初のバージョンを大幅に改善できます。可能であれば、下書きを保存し、後で編集するために戻ってくることをお勧めします。


少なくとも、出版前にテキスト全体を読み直すことで、言い方を微調整して、テキストに対する読者の全体的な印象を改善できるはずです。


編集は、優れた読者体験の鍵です。自分で書くことは、あなたが書くほとんどのものにとって十分であるはずであり、それはあなたの読者にとって基本的な礼儀です.

画像の説明


自動化されたツールを使用して文章を改善する


機械が文章を改善できる方法は、辞書チェックだけではありません。最近では、次のようなことを処理できる高度なツールが利用可能です。


  • 間違った場所で使用されている正しいスペルの単語をキャッチします (「then」と「than」で常に行っているように)。


  • 受動態のマーキング—能動態を使用すると、文章がより鮮明になります。


  • 読みやすくするために文を再編成します — 少なくともアルゴリズムに従って。


執筆に真剣に取り組んでいる場合は、利用可能なアプリケーションをいくつか検討する必要があります。

文法的に

同様の YouTube 広告を受け取った場合は、間違いなく聞いたことがあるでしょう。 2021年7月から使用していますが、満足しています。これは、私がブログに実装した最初の重大な品質改善でした。


プラス:


  • 単語の文脈を理解し、それに応じて変更を提案します。「それは」または「その」のどちらを意味するかを教えてくれます。

  • 使いすぎた単語を指摘し、他の選択肢を提案します。

  • 有料版では、文章の再構成を提案できます。


マイナス


  • 英語以外の言語のサポートの欠如。
  • Mac 上の Firefox プラグインは、Google ドキュメントとうまく機能しません。
  • 有料版は年間 144 ドルで、競合他社よりも高額です。
  • セキュリティとプライバシーの問題について聞くことができます。私が調べたところ、最も重大なセキュリティ侵害は 2018 年に発生し、迅速に修正されました。プライバシーの問題は、会社のサーバーで発生するすべての処理に関連しているため、会社がサービス条件に従うことを信頼する必要があります.

言語ツール


プラス:


  • より多くの言語 (5 つのヨーロッパ言語の文法修正)、20 の言語のより基本的なサポートなどをサポートします。
  • 無料版は自己ホストできるため、データは完全に管理できます


マイナス:


  • マーケティングが減る - 周りに尋ね始めて初めて見つけた

画像の説明


読者の親友になる

これらのヒントはすべて、あなたの文章を読む人のことを考えることです。あなたの仕事は、彼らがそれを読みやすくすることです。


それはより共感的であることを求めます。多くの場合、読者はあなたの上司やあなたのキャリアに影響を与える人々です。


同僚に向けて文章を書く場合でも、おそらく多くの同僚がいるでしょう。それは、効率的なコミュニケーターとしての評判を築くのに役立ちます。


以前こちらで公開。