タグ

文章に関するroygbiviroのブックマーク (21)

  • 小学生に教えるために編集者歴17年の父親が本気で考えた…「きちんと伝わる文章」を書く10のコツ 「説明ができる」とは「生きる力がある」ということ

    「伝わる文章」とはどのようなものか 私はWEB媒体の編集者/ライターをかれこれ17年ほどやっている。日語で情報を伝えるのが仕事だ。 ジャンルとしては長文の体験レポートを中心に扱ってきた。ライトな読み物で、書くのも簡単そうだと思われるかもしれない。いやいや、そうでもないのだ。それぞれのバックグラウンドを持ち観察力に優れた書き手が、五感をフルに使い数時間かけて体験取材をすると、情報量がとんでもないことになる。それを限られた字数で読者にわかりやすく伝えるのは、実は技術のいる作業なのだ。 また、私は特に編集部の中でも新人ライターを多く担当しており、書き慣れない人が書いた文章を一緒に直し、読み手に伝わる書き方をアドバイスする経験をずっと積んできた。 そんな私が、小学生の子供の中学受験によってあらためて「伝わる文章の書き方」を見つめ直すことになった。稿ではその経験について少し語らせてほしい。

    小学生に教えるために編集者歴17年の父親が本気で考えた…「きちんと伝わる文章」を書く10のコツ 「説明ができる」とは「生きる力がある」ということ
  • テキストコミュニケーションで意識していること|ymdkit

    リモートワーク仕事をしていると、Slack や Teams といった何かしらのチャットツールでコミュニケーションを取ることが多い。そうやって仕事を続けていく中で「こう伝えたらよりスムーズに話が進んだかな...」という後悔は多々あり、日々試行錯誤を続けている。 そうやって試行錯誤を続けていく中である程度テキストコミュニケーションを取る上でのフォーマットが定まってきた気がするので、箇条書きでまとめてみようと思う。(随時更新予定) prefix (接頭辞)をつける文章の先頭にその文章の目的がわかるような prefix をつけて、何のためにポストしたかを一目で分かりやすくする。例えば以下のような prefix をつけることがある。 【質問】→ 相手の返信が欲しい時 【共有】→ 返信は不要だが、内容は把握しておいてほしい時 【メモ】→ 返信不要で、後から検索できるよう残しておきたい時 箇条書きする

    テキストコミュニケーションで意識していること|ymdkit
  • 【例文あり】「頼むの苦手」を克服! 依頼メールの書き方・件名・締めの言葉のコツ - ミーツキャリアbyマイナビ転職

    メールのやりとりは社会人である以上避けては通れないもの。手軽なチャット機能やメッセージアプリのテキストコミュニケーションが普及しても、ビジネスではメールがまだ重要な役割を果たしています。 しかし、ビジネスメールの書き方、特にメールで初めてお願いごとをする依頼メールに苦手意識を持つ人は少なくありません。また、仕事ができる人やコミュニケーション上手と言われる人は、ビジネスメールの文面にも表れます。この記事では、ビジネス依頼メールの書き方や件名、締め文の留意点、相手をイラっとさせないポイントなどを解説します。 初めてのビジネス依頼メールの書き方。件名、締めの言葉などコツ8つ ビジネス依頼メールの書き方【1】件名で要旨が分かるように ビジネス依頼メールの書き方【2】宛名は変換ミスに注意! ビジネス依頼メールの書き方【3】挨拶文は署名とともに社内・社外のテンプレ登録して時短 ビジネス依頼メールの書き

    【例文あり】「頼むの苦手」を克服! 依頼メールの書き方・件名・締めの言葉のコツ - ミーツキャリアbyマイナビ転職
  • 技術をわかりやすく伝えるためテクニカルライティング

    技術をわかりやすく伝えるためのテクニックとしての「テクニカルライティング」を学べます。Developers Summit 2023の登壇資料。開発者・エンジニアの方向け。 https://twitter.com/naoh_nak

    技術をわかりやすく伝えるためテクニカルライティング
  • 難関中学の入試問題の原作者になったけど設問が解けない理由を考えて、編集者にたどり着いた|岸田奈美|NamiKishida

    2023年2月3日、日付が変わるギリギリで思い出した豆をひとりで、鬼のお面をしながら、四方八方にまき散らしていたときでした。鬼みずから。少子化。 「岸田奈美さんのエッセイが、難関中学の今日の入試問題に出ました!」 なんですって! 調べたところ、東京の筑波大学附属駒場中学校だった。都内……偏差値……1位……!? 昨年は、京都大学医学部の入試でミャンマー行きのエッセイを、灘中学校の模試でバズった母のエッセイを使ってもらった。偏差値が、偏差値が軽々とスキップでわたしの頭を飛び越えていく。 出題されたのは、光村図書「飛ぶ教室 第65号(2021年4月発行)」に寄稿し、「ベスト・エッセイ2022(2022年8月発行)」に転載されたエッセイ。 ダウン症の弟が、ガラスを割った罪を、近所の子どもからなすりつけられそうになったときのこと。なつかしい。 設問も一緒に、読ませてもらったから、解こうとした。 結果

    難関中学の入試問題の原作者になったけど設問が解けない理由を考えて、編集者にたどり着いた|岸田奈美|NamiKishida
  • 読みやすいドキュメントを書くために今日からできる7つのこと|壮|Masato Tanaka

    こんにちは。壮(@sew_sou19)と申します。 メガベンチャー企業でエンジニアとして働いています。 エンジニアにジョブチェンジした当初は、ドキュメントの書き方なんてこれっぽっちも分かりませんでした。読みやすいドキュメントを書くことが当に苦痛だったのですが、考えて、試行錯誤し続けた結果、以下のような評価を得るに至りました。 リーダーから「君は情報の整理が上手でドキュメントが当に読みやすい。チーム全体の能力向上に繋げたいからドキュメント書く際のポイント共有してほしい」と言われたので、意識していることを言語化しつつテクニカルライティングのでインプットしてるけど、学びが多い。ついでにnoteにもまとめてる — 壮 (@sew_sou19) November 28, 2022 そこでこのnoteでは、僕がドキュメントを作成するときに、特に意識して実践している7つのことを書きます。(当は2

    読みやすいドキュメントを書くために今日からできる7つのこと|壮|Masato Tanaka
  • 果てしない文章推敲を「3ステップ」で効率的に終わらせる方法|石原尚(大阪大学教員)|note

    文章は、「これで伝わるだろう」という淡い期待を簡単に裏切ります。伝えたいことを期待通りに伝えられるようになりたいのなら、「表現の質」を高めるための推敲の技術の習得が不可欠です。 この記事では、大切ながら手間のかかる推敲を「効率的に」実施する方法を紹介します。ほとんどはじめて論文を書くことになった学生さんが、論文原稿(卒論・修論)の価値を飛躍的に向上させるうえで役にたちます。また、論文に限らず、「正しく、詳しく、丁寧に伝えたい」という気持ちで文章を書こうとする場合には、さまざまな場面で使えるはずです。 この記事で紹介する推敲の手段は、「切り分ける・並び替える・繋ぎ方を変える・削り落とす・一貫させる・まとめる・明確にする・限定する・やさしくする」の9種類です。この9種類さえ自由自在に駆使できれば、論文の文章を劇的に良くすることができます。この9種の推敲を、「まず工事して、片付けて、最後に気遣い

    果てしない文章推敲を「3ステップ」で効率的に終わらせる方法|石原尚(大阪大学教員)|note
  • Obsidian がすごくいい

    Obsidian(オブシディアン) と出会ってまだ3日目ではありますが、ここ最近で一番興味をそそられるアプリだったので紹介します。 A second brain, for you, forever. https://obsidian.md/ 出会いの経緯 を眺めていたときに一つの記事が目に付きました。 私がソフトウェア開発者として Notion から Obsidian に移った理由トップ3 何やら少し挑戦的なタイトルです。私も情報を整理するときに Notion はよく使用しています。不満がないとは言わないものの、Notion の機能を超える情報整理ツールは中々ないことくらいはわかります。 気になった記事は、まず読んでみることです。 読みながらの感想 "Obsidian" ……なんて読むの?カタカタ……オブシディアン。いやー、スペルも読み方も覚えられないなぁ……。どんな意味なの?カタカタ……

    Obsidian がすごくいい
  • 伝わる文章 | 基本要素 | SmartHR Design System

    相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況(読む場面、事前知識など)を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1:法律や業務に関わる記事目的業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before日の年金制度は、全国民

    伝わる文章 | 基本要素 | SmartHR Design System
  • テクニカルライティングの基本

    テクニカルライティングの基を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter:https://twitter.com/naoh_nak 2023年度のアップデート版もあります:https://speakerdeck.com/naohiro_nakata/technicalwriting2023

    テクニカルライティングの基本
  • うまい文章をラクに書くための「たったこれだけ」の工夫5選。 - STUDY HACKER(スタディーハッカー)|社会人の勉強法&英語学習

    「文章をうまく書くには、やっぱり訓練が必要……? でも面倒なことはしたくない」 「難しいことや特別なことをしなくても、文章力がアップする方法を知りたい!」 このような人に向けて、うまい文章をラクに書くための “ちょっとしたコツ” を5つご紹介します。メール、チャット、報告書など、あらゆるビジネスシーンで使えるものを集めました。誰でも簡単に実践できますから、読んだら “即” 使ってみましょう。 1. 一文を「短くする」だけ 仕事の情報は複雑で、文章にするとどうしても込み入ってしまうもの。もっとスマートに書きたいのに……と思うなら、「一文を短くするだけ」で効果的です。 数々のヒット作を生み出すコピーライターで、“端的に文章を書くプロ” である橋口幸生氏。同氏は、読みやすい文章を書くには、一文を40~60字以内にまで短くするとよいと言います。 これは、一文に書く内容をひとつに絞ると実現できるとの

    うまい文章をラクに書くための「たったこれだけ」の工夫5選。 - STUDY HACKER(スタディーハッカー)|社会人の勉強法&英語学習
  • 穴埋めするだけで論文を作れるWebフォーム 便利すぎて無情な現実を突きつけてくると話題に

    「めちゃくちゃ有用だけど、きつい現実を突きつけられる」──こんな口コミで、あるWebサイトが話題になっている。「データはどのように収集しましたか?」「この論文で検証したいことは何ですか?」など複数の設問に回答することで、論文の骨組みを出力してくれるWebフォームだ。 設問は、データの正確性、研究の正確性、研究の意義、研究の必要性の4種類に分かれており、それぞれのテーマに沿った質問を用意している。入力した後は「論文骨子へ変換」をクリックするだけで、論文タイトルから要旨、実験方法、結論などを表示する。 作成したのは「独学大全」などの書籍で知られる、作家の読書猿(@kurubushi_rm)さん。自身のブログに「論文に何を書くべきか→これだけは埋めろ→論文作成穴埋めシート」と題して2012年2月に投稿したものだ。「穴埋めしたら論文を出力してくれるものが作れないか」という話を受けて、シートを作成し

    穴埋めするだけで論文を作れるWebフォーム 便利すぎて無情な現実を突きつけてくると話題に
  • 「という」と「こと」を削って文章のもたつきをとる【WEB文章術】 | センスも文才もなくていい 発信力を上げる「WEB文章術」 | mi-mollet(ミモレ) | 明日の私へ、小さな一歩!(1/2)

    ミモレで2021年に公開された記事のうち、特に人気があったものをご紹介します。よろしければぜひご一読ください。 無意識に使ってしまいがちで、“文章のもたつき”を生む言葉に「という」と「こと」があります。「という」と「こと」を減らし、言い換えるコツをご紹介します。 「という」はなくても成立することが多い 話し言葉に近い文体で書くブログやWEB記事は、普段の口グセ・言い回しのクセがそのまま文章に出やすいですよね。前回ご紹介した「のですが」同様、「という」も、無意識にクッション言葉として使いがちです。私自身もインタビューの録音をテープ起こしのために聞くと、「〜なんですが」と「〜という」「〜っていう」を多用していることに気づいて反省します。 「〜のですが」や「という」「ということ」など、話し言葉では語気をやわらげるクッション言葉も、文字として連続するとより目障りでまどろっこしい印象に。私はこれを「

    「という」と「こと」を削って文章のもたつきをとる【WEB文章術】 | センスも文才もなくていい 発信力を上げる「WEB文章術」 | mi-mollet(ミモレ) | 明日の私へ、小さな一歩!(1/2)
  • 感想文得意だったタイプです。コツみたいなものを書くので参考にしてもら..

    感想文得意だったタイプです。コツみたいなものを書くので参考にしてもらえればと。 まず前提として「正しさ」だけで書こうとするのは止めるべき。 書評は論文じゃないんだから、増田を読んで感じたことや思ったことを書けばいい。 とはいえ、読了後に感想が全く出てこない場合もある。 これは内容の周辺知識が足りないパターンが圧倒的に多いので、そういうときは素直に知識不足を認めた上で書く。 例えば増田の 1+1=2という記載に疑問のもちようがないというのも 「1 + 1 = 2であることに納得はできた。しかし、私は数学に疎く1 + 1 = 2が実生活でどのように役立つのか想像もできない。具体例がもう少し記載されていれば良かったのだが。」 とか、なんとでも書ける。 周辺知識が無い場合、想像で書くこともできる。 「1 + 1 = 2が筆者の主張だが、1 + 2 = 3なのだろうか?私にはそうは思えない。なぜ

    感想文得意だったタイプです。コツみたいなものを書くので参考にしてもら..
  • テックブログに関わる人に読んで欲しい、「エンジニアの文章をレビューする」技術|中川 伸一 / Engineer Manager

    気がつけば久々のnoteになってしまいましたが、私は元気です。 近況は...最近鍛えながら健康やせしたのでプロフィール写真を撮影し直しました、そのうちnoteに書こうと思います。 それはさておいて、4月に「週刊はてなブログ」さんの企画でこんなインタビューに答えました。 もうすぐ7年目を迎える個人技術ブログ「Lean Baseball」および、所属するJX通信社の「JX通信社エンジニアブログ」の話をメインに、「自分が書きたいことを書くことによって自分のキャリアにもつながるしなんだったら人のキャリアにもいい影響あるんやで」という話をしました(究極に端折るとそういう話です)。 補足で書いた番外編を含め、色々と好反響を頂き嬉しかったですありがとうございます。 一人のエンジニアであり、一人の技術ブロガーである私の物語としてはこれはこれで良いのですが、 テックブログに関わる人達が、エンジニアの気持ちを

    テックブログに関わる人に読んで欲しい、「エンジニアの文章をレビューする」技術|中川 伸一 / Engineer Manager
  • 質の高い技術文書を書く方法 - As a Futurist...

    大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは? 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 番環境に変更を加えるにあたっての包括的な情報や具体

    質の高い技術文書を書く方法 - As a Futurist...
  • 部下から「議事録ってなんで作成する必要あるんですか?」と聞かれたので議事録の必要性について図解してみた

    ごらり @gorizukai 部下から「議事録ってなんで作成する必要あるんですか?」と聞かれたことがあるので、今後聞かれたときのために議事録についてまとめてみました。議事録って慣れるまでは大変ですけど、文章の書き方が学べたり、社内人脈ができたりするので入社したての頃は特に進んで議事録作成することを勧めたい。 pic.twitter.com/xV0REtbeVD 2020-11-03 20:56:44

    部下から「議事録ってなんで作成する必要あるんですか?」と聞かれたので議事録の必要性について図解してみた
  • LINE社内テクニカルライティング講座第2弾!1文では説明が終わらない文章を書くコツ

    こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む

    LINE社内テクニカルライティング講座第2弾!1文では説明が終わらない文章を書くコツ
  • LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた

    LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま

    LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
  • 今日から使える文章校正テクニック | DevelopersIO

    渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。 AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると

    今日から使える文章校正テクニック | DevelopersIO