LINE社内テクニカルライティング講座第2弾！1文では説明が終わらない文章を書くコツ
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む
文書品質の向上と文書作成時間の短縮：｢考えが文にまとまらない」を解決するためのテクニカルライティング
<BODY BGCOLOR="#ffffff" LINK="#ffffff" VLINK="#ffffff" ALINK="#ebc83d"> <P> <IMG SRC="fig-t8a/gb-bar-introduction.gif" ALT="テクニカルライティングの効果" ALIGN=bottom width="540" height="26"><BR> <IMG SRC="fig-t8a/tw8a-ttl.gif" ALT="文書品質の向上と文書作成時間の短縮" ALIGN=bottom width="570" height="150"><HR> <H1 style="line-height: 150%"><span style="font-weight: 400; letter-spacing: -1pt"> ｢<font color="#800000">考えが文にまとまらない<
小論文の添削でしょっちゅう指摘したこと - らいおんの隠れ家
うめぇヨーグルトソースでもいかがですか。個人差にもよりますが。もしよろしければ。 お久しぶりです。 最近うんめぇ〜と思ってるヨーグルトソースがあるので、書いていこうと思います。 ヨーグルトとハーブ類をもりもり使うので、そういうのが食べられない方にはうんめぇソースではないです。ごめんなさい…。もしよろしければお茶だけも…旦~ 【用意する…
文章力とは、この世を生きる力である
これまで読んできた文章術の本の中で、トップクラスに入る良書です。本書を読めば、細かいテクニックは抜きにして「人に読んでもらうに値する文章」を書くためのコツを知ることができます。 誰も教えてくれない人を動かす文章術 本音を言うと、本書は紹介したくなかった。ライバルが増えてしまうから（笑） 凡庸さは恥 文章においては、凡庸さは恥です。結果としての凡庸さはある程度しかたがないとしても、せめて「凡庸さは恥」だということを肝に銘じておきたい。実は、このことを知ってもらうことこそ、私が本書を書くにあたっての、隠されたテーマなのです。 脳天をガツンと叩かれたような感覚でした。私は以前から「万民に受ける記事=誰にも読まれない記事」という持論を持っていたので、勇気をもらえました。 「どっちも大事」みたいな理想論をアップしていたら、まったく見向きもされなかったと思います。「それができれば苦労はしない」的なコメ
文章を書くノウハウを伝授
ITエンジニアにとって文書作成技術は欠かせません。日常のメールのやりとりにはじまり、要件定義書、機能仕様書、企画の提案書など、上司やチーム、顧客などに対して、文章でコミュニケーションをとる機会がとても多いからです。 連載『悪文と良文から学ぶロジカル・ライティング』では、論理的にわかりやすい文章を書くノウハウを伝授しています。ITエンジニアが日常的に用いるであろう文章を例に使い、どこが悪くてどう直せばいいのかといったポイントをわかりやすく解説しています。実践すれば、誰でもすぐにわかりやすい文書が書けるようになるはずです。 オリエンテーション ITエンジニアにとって「書く技術」とは？ 文書の全体構成を組み立てられるようにする 内容を大きく分けて項目を立てる 適切な順番で項目を並べる 話の階層をそろえる 文章表現の基本ルールをマスターする 主語と述語を対応させる 修飾語と被修飾語をはっきりさせる
[書評]日本語作文術 (中公新書：野内良三）: 極東ブログ
タイトルが冴えないけど「日本語作文術 (中公新書：野内良三）」（参照）は良書だった。文章読本の系統では新しい古典になるのではないか。レベルは一般向け。高校生が読んでもよいくらい。大学生や新社会人も読んでおくと、一生のお得。悪文を書き連ねている私がいうのもなんだけど、これ読むと、それなりに文章がうまくなることお請け合い。 文章読本は数多くある。ありすぎる。人それぞれ信奉する良書もある。なので、どれが良書かという議論は、ご宗教みたいな話に堕しがち。どうぞご勝手に。私はある時期からあまりこだわらず、そのときおりの文章読本を時代を読むように読むようになった。文章読本自体を楽しむという趣向では「文章読本さん江 (ちくま文庫：斎藤美奈子）」（参照）のような冷めた感じだ。文章というのは多面的で一冊の文章読本ですべてを言い尽くせるものでもないし。 それでも信奉書に近いものはあって、平凡だが二冊。「日本語の
読みやすい文章を書くための技法 - RyoAnna
『坊っちゃん』自筆原稿 読みやすい文章とは、流れるように読める文章だ。難しい言葉はいらない。気のきいた言葉もいらない。文頭から文末まで振り返ることなく読める文章が、最も美しい。 読みやすさの基準は客観的なものだ。読み手には様々な人がいる。老若男女すべての人に対して読みやすい文章を書くのは難しい。ただ、綺麗な文章を書こうとする意識は持ちたい。 文章を書く上で意識すべき技法を紹介する。 常体と敬体 常体とは「だ・である」調の文章であり、敬体とは「です・ます」調の文章を指す。それぞれにメリットとデメリットがある。 常体は、自分の意思を力強く伝える事ができるが、我の強い文章になる。敬体は、優しい印象で共感を得やすいが、まわりくどい文章になる。 常体と敬体を織り交ぜて書く手法もある。まずは自分で試してみて、書きやすい文体を見つければいい。 文章の始まりは短く 最初の一文は短いほうがいい。インパクトが
論文の書き方
残念ながら普段大学生は基本的な論文の書き方を大学の授業で学ぶことがない。論文の書き方、というのは学生の学ぶ必須事項でありながら、大学側は誰一人として「一般的な論文の書き方」というものを教えないのだ。これは僕のゼミでもそうであり、知る限り他のゼミでもそうであるように思える。また、もしゼミ内で教授していたとしても、それは不公平であり、一般的な書き方、書く上でのルールなどのガイドラインは全学生に対して行われるべきだと思う。特に実験レポートを主とする理系論文と違って、社会科学系論文ではその内容の合理性・説得力に重点が置かれることになり、論文自体の構成がそのものの評価に関わって来ることは自明である。 ここではイギリスで一般的に学生に求められる論文の書き方を紹介したいと思う。どういった骨格でレポート、論文をまとめたらよいかわからないと悩む学生の助けになれば幸いに思う。また、この論文の展開は学問的論文に
わかりやすい技術文章の書き方
誰が読むのか。 読み手にどんな感想を持ってもらいたいか。 読み手はどれくらいの予備知識を持っているか。 読み手はどんな目的で、何を期待して読むのか。 読み手が真っ先に知りたいことは何か。 レポート・論文とは何か 問いが与えられ、または自分が問いを提起し、 その問題に対して明確な答えを与え、 その主張を論理的に裏付けるための事実・理論的な根拠を提示して、主張を論証する。 標準的な構成要素とは何か レポート・論文の構成は、 概要 序論 本論 論議 という要素が標準的である。次にそれぞれの要素について簡単に見てみる。 概要 論文全体を結論も含めて、すべて要約する。 序論 本論で取り上げる内容は何か。 その問題をどんな動機で取り上げたのか。 その問題の背景は何か。 その問題についてどんなアプローチを取ったのか。 本論 調査・研究の方法・結論 論議 自己の議論・結論を客観的・第三者的に評価する。 そ
学術論文の書き方のメモ - forest book
7年前の、当時、修士1回生のときに受講していた「科学技術表現」という講義のメモが出てきたので(自分用に)整理してみました。メモ書きなので講義を受講していない人には分かり難いかもしれません(^ ^;; 学術論文は、技術文書とは違い、内容の良し悪しに加えて、それが論文としての「体」をなしているかが重要です。数年前のお話なので、もしかしたら、現在はその「体」が少し変わっているかもしれません。ご参考まで。 早く安く作った論文やアルゴリズムはまったく独自の自分の考えしか残らない 論文の流れ タイトル 概要(アブストラクト) 序論(はじめに) 一番難しいので最後に書く 関連研究、問題意識、研究目的 本論部 アイディアの提示 実験 本論部と実験は、ちゃんと出来ていれば易しい 結論 繰り返しでも良いのでやったことを書く まとめと再アピール 長めに書く 論文のタイトル タイトルの使われ方 目次をざっと見て、
【横書き文章術】「説得できる文章・表現200の鉄則 第4版 ネット時代の横書き仕事文はこう書く」 : マインドマップ的読書感想文
【本の概要】◆今日お送りするのは「文章作成のアンチョコ」（？）。 読書する、というタイプの本ではなく、まさに「道具（ツール）」です。 アマゾンの内容紹介から。1ページ1項目、パッと見て分かるルールと具体例。92年発行の初版から企業のビジネスコミュニケーションのバイブルとして愛用されてきたロングセラーの全面改訂版です。説得力のある文章の書き方から、ビジネス電子メールの作法や実例、そして画面で読む文章の注意点まで、ネット時代にふさわしい内容に一新。文章作成の悩みにズバリ答えます。 ブログより、むしろ「ビジネスシーン」で活躍してくれそうな1冊かと。 いつも応援ありがとうございます！ 【目次】第1章 説得力のある文章を書く 文章執筆の勘所を押さえよう 段落執筆の極意 タイトル、見出しを工夫してもっと分かりやすく 箇条書きにもルールやコツがある 誤解を招かない文を書こう 分かりやすい文を書こう 簡潔
悪文と良文から学ぶロジカル・ライティング 目次
ITエンジニアにとって文書作成技術は欠かせません。日常のメールのやりとりにはじまり、要件定義書、機能仕様書、企画の提案書など、上司やチーム、顧客などに対して、文章でコミュニケーションをとる機会がとても多いからです。 本連載では、論理的にわかりやすい文章を書く「ロジカル・ライティング」のノウハウを伝授します。ITエンジニアが日常的に用いるであろう文章を例に使い、どこが悪くてどう直せばいいのかといったポイントをわかりやすく解説します。実践すれば、誰でもすぐにわかりやすい文書が書けるようになるはずです。 連載目次 ●オリエンテーション ・ITエンジニアにとって「書く技術」とは？ ●文書の全体構成を組み立てられるようにする ・内容を大きく分けて項目を立てる ・適切な順番で項目を並べる ・話の階層をそろえる ●文章表現の基本ルールをマスターする ・主語と述語を対応させる ・修飾語と被修飾語をはっきり
正確な文章の書き方
このページでは、正確な文章を書くための秘訣をまとめてみようと思います。それほど文章がうまいとはいえない私が、文章の書き方について述べるのですから、むこうみずな行為であることは百も承知です。しかし、数年に渡って探求した正確な文章の書き方が、少しでもみなさんの役に立てばという思いを自分への励ましに代えて筆をとります。 ここでお話するのは、「文章をいかに正確に書くか」や「自分の考えをどうやったら適切に表現できるか」であって、決して「どうやったら人を感動させる名文句が書けるのか」ではありません。 このページを読んだら「科学技術文献」を書くための技術が少しは身に付くのではないかと期待しています。しかし、 人はいさ 心も知らず ふるさとは 花ぞ昔の 香ににほひける (紀貫之) などのような心に残る文章が頭に浮かぶようになるわけではありません。 絵の書き方に例えて言うなら、ここで述べる内容は、色彩や調和
仕事で文書を書く必要がある人は理科系の作文技術を読むべきだ - 未来のいつか/hyoshiokの日記
仕事で文書を書く必要がある人は「理科系の作文技術」(ISBN:9784121006240)を読むべきだ。 ここでいう仕事で書く文書というのは他人に読んでもらう文書をさす。他人に読んでもらうことを前提としないメモの類や狭義の日記などはこれにあたらないので、どう書こうが構わない。他人に読んでもらうことを前提とした文書は、相手に内容が伝わらなければ意味がないのだから、間違いなく相手に通じるように表現しなければならない。 小説、詩などの文学作品は、ここでいう「仕事で書く文書」に含めないことにする。文学作品と対比して、仕事で書く文書の特徴はどこにあるのか。それは、読者に伝えるべき内容が事実と意見にかぎられていて、心情的要素を含まないことである。 仕事の文書を書くときの第一の原則は、「必要なことは洩れなく記述し、必要でないことは一つも書かない」ことである。何が必要かは目的により、また相手の要求や予備知
文章技術ねえ - finalventの日記
文章技術のことにとやかく言える立場にないけど、ちょっと。 inspired byあなたの文章を（ほんの少し）綺麗に見せる九つのテクニック。 - Something Orange 一、理想をもつ。 これはわからないな。物を書くという内的外的な必要性というものに付随することではないかな。 二、リズムに留意する。 これは２つ。１、読んでみて息づかいがあるか、２、用語（漢字）が適切に選ばれているか。 日本語の場合、漢字をうまく配置するとリズムが生まれる。「と言っても過言ではない」「寡聞にして」みたいのはそれの壮烈な失敗例。なので、成語をきちんと文脈でうまく使えるように、それなりに堅い文章を日頃読む必要はあるかも。 で、この成語の使い方なんだけど、よくある文章術は、わかりやすく書け、だけど、そうすると、リズムはばらけるのですよ。わかりやすさというのは、意外に難物。 三、ただひたすら削る。 そういう言
「プロらしさ」を生むWeb文章校正の５大鉄則：NBonline(日経ビジネス オンライン)
校正というと、誤字・脱字をチェックしたり、「てにをは」の修正をしたりといった作業を思い浮かべる人も多いのですが、これは間違いです。もちろん、こうした行為も校正の一つではありますが、もっと大切なことがいくつもあります。 原稿というのは、不思議なもので、書き上げたばかりのものよりも、寝かせて見直して、手直しを入れたもののほうが、はるかに出来がよくなります。「勢いで書き上げる第一稿、落ち着いて見直す第二稿」とか「ラブレターと原稿は一晩寝かせてから提出する」という言葉が、物書きの間では、よく出てきます。 もし、あなたが勢いで書き上げた第一稿を見直さず、クライアントに提出したり、Webサイト上に掲載したりしたらどうなるでしょうか？ ほとんどの場合、誤字・脱字があったり、読みづらい文章があったり、間違いがあったりするでしょう。 原稿の品質向上のためには、見直す時間も考慮して、スケジュールを組み立てるこ
第7回 ［文章術］似通った名前には要注意
今回は，図解というよりも「文章」についてのお話しです。 もっとも，実は私が扱っている「図解術」は「言葉の使い方」をこれでもかというぐらい重視しているものなので，「図解術」と言いつつ「文章術」的な面がもともと強いのです。実際，ここまでの連載の中でも，「言葉の使い方」について少なからず触れていました。（下記にその例を挙げます） 第4回 ［図解術］違うものは，違うとわかるように表現しようの中の『同じ言葉を違う意味に使っていませんか？』の項 第6回 ［図解術］対称的な関係をしつこいぐらいに探してみようの中の『「対称性」は情報を構造化するための重要な視点』の項 今回のテーマは「似通った名前には要注意」です。いったいどんな話でしょうか。まずは下記文面を見てください。 ＜例文1＞ 被監査部門による内部監査の実施を受けて，監査チームが監査報告書を作成します。その報告書は監査事務局長と監査管理責任者により承
「話し過ぎ」の人はいませんか?
自分では気がつかないけれども，他人からはよく見えることがあります。そのひとつが，「話し過ぎ」です。筆者は若いころ「話し過ぎ」でした。今ならそう自覚できますが，当時は「話し過ぎ」とは思っていませんでした。 このように，「話」には自分自身で見えにくいため，課題がよく自覚できないという非常に困った特徴があります。そして，これが非常に曲者なのです。 たとえば，文書なら，「書き過ぎ」かどうかは自分でも分かります。落ち着いて第三者的な立場で，自分の書いた文書を見れば，それが「書き過ぎ」かは分かるものです。 例えば，以下の文書を見てみましょう。
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ポール・グレアム「文章術・簡易版」 - らいおんの隠れ家