2 ポイント 投稿者 GN⁺ 2024-04-07 | 1件のコメント | WhatsAppで共有

文章を書くときに編集で考えること

  • 文章を正確に伝えよ

    • 書き始める前に、何を伝えたいのかを決める必要がある。
    • テーマや対象読者などを考慮して文章の目的を明確にし、それを文書の冒頭に記しておく。
    • 書く・編集する過程でこの目的と照らし合わせ、一貫性を保つ。
  • 妥当な範囲で繰り返せ

    • 読者が主題を理解できるよう、文章の始めと終わりで主題を再確認する。
    • 明確さのためには、動詞ではなく名詞を使って繰り返すと役立つ。
  • 単純化せよ

    • 不要な言葉を削り、文を簡潔にする。
    • 「あなたは」や「あなたができる」のような表現は、簡潔な命令文に置き換える。
    • 長い文は短く分け、読者の理解を助けるために読点を適切に使う。
  • 受動態をなくせ

    • 受動態は行為者を曖昧にし、文を不明瞭にする。
    • 能動態に変えると、文はより明確になり理解しやすくなる。
  • 副詞を使うな

    • 副詞の代わりに、より具体的な動詞を使うか説明を加えて表現する。
    • 副詞はしばしば読者に正確な意味を伝えられず、曖昧さを残す。
  • 知識を前提にするな

    • 読者が知らないかもしれない情報には、適切な背景説明を加える。
    • 略語を初めて使うときは、正式名称を書いたうえで説明を添える。
  • トーンを意識せよ

    • 文章のトーンは一貫しているべきで、親しみやすいトーンと形式的なトーンを混在させない。
  • 専門用語とクリシェを避けよ

    • 正確な表現を使い、読者が理解しやすいようにする。
    • 専門用語は、読者が特定の集団に属していない場合、理解しにくいことがある。
  • 余白を活用せよ

    • 長い段落を分け、小見出し、リスト、表などを使って読者の読みやすさを高める。
    • 重要な内容は太字で強調し、読者が主要なポイントを見落とさないようにする。

結論

  • 文章を編集する基本原則は、意味を明確に伝え、不要な言葉を取り除くことにある。
  • こうした原則に従いながら、自分自身のスタイルや好みを育てていける。
  • 編集の目的は、言葉の使い方について考え、メッセージの伝達に適した選択をすることにある。

GN⁺の見解

  • 編集の過程で文章の目的と一貫性を保つことは、あらゆる文章作成において重要な原則である。
  • 受動態の使用は特に技術文書で避けるべきスタイルであり、能動態への切り替えは明確さの向上に寄与する。
  • 副詞の使用を避け、具体的な表現を使うことは、技術文書だけでなくあらゆる文章作成で効果的である。
  • 読者が知らないかもしれない情報への背景説明は、特に技術文書で重要であり、読者の理解を高め、文書のアクセシビリティを向上させる。
  • 余白と視覚的な区切りを使うことは、オンラインコンテンツの読みやすさを向上させる重要な要素である。

1件のコメント

 
GN⁺ 2024-04-07
Hacker Newsの意見
  • 1つ目のコメント要約:

    • 投稿者は、自分の文章が多くの人の共感を得られて光栄だと述べている。
    • 好奇心に導かれてソフトウェアエンジニアになり、数年間働いた後、執筆中心の役割が恋しくなったという。
    • 技術スキルとコミュニケーション能力を組み合わせた役割を探しており、連絡先はウェブサイトとLinkedInで確認できる。
  • 2つ目のコメント要約:

    • 技術文書で略語を導入せずに使うのは不親切だとしている。
    • 略語がプロジェクト文書で繰り返し使われ、メンバーが入れ替わると、その意味を知る人がいなくなる可能性がある。
    • 略語を固有名詞のように扱って使い続けることが、唯一の解決策になる場合もある。
  • 3つ目のコメント要約:

    • 技術文書のレビュアーとして、多くのガイドラインを使ってきたという。
    • 同じものを別の名前で呼ばないことを、追加で提案している。
    • 著者が複数いる場合、用語の揺れが読者の混乱を招くことがある。
  • 4つ目のコメント要約:

    • 「受動態を避けるべき」という助言には同意できないとしている。
    • 受動態は、行為に対する視点を変えられる道具だという。
    • 受動態を使うことで、その行為の主体に言及するかどうかを選べる。
  • 5つ目のコメント要約:

    • 誰のために書くのかを決めるのは難しいと述べている。
    • 技術的な読者、一般的な読者、非技術的な読者など、さまざまな読者を考慮する必要がある。
    • より多くの読者にアクセスしやすい文章にしようとする試みと、長さを抑えたい気持ちの間で葛藤している。
  • 6つ目のコメント要約:

    • 文章力の改善に対する熱意を表している。
    • リストを使うことの重要性と、適切な使い方について助言している。
  • 7つ目のコメント要約:

    • "just" という単語の使用を避けるよう提案している。
    • "just" は単純さを示唆するが、実際にはそうでないこともある。
  • 8つ目のコメント要約:

    • 技術文書だけでなく、ブログやメールなどでも余白の重要性を強調している。
    • 長い段落は読みにくく、人は注意を失いやすい。
  • 9つ目のコメント要約:

    • 過去にMSPで働いた経験から、よく書かれた運用ガイドの重要性を認識したという。
    • 新聞で得た経験も踏まえ、文書作成に役立つガイドラインを探そうとしている。
  • 10つ目のコメント要約:

    • 未来形の使用を避けるよう提案している。
    • 文書では「こうすれば〜するだろう」よりも、「こうすれば〜する」と表現するほうがよい。