果てしない文章推敲を「３ステップ」で効率的に終わらせる方法｜石原尚（大阪大学教員）｜note
文章は、「これで伝わるだろう」という淡い期待を簡単に裏切ります。伝えたいことを期待通りに伝えられるようになりたいのなら、「表現の質」を高めるための推敲の技術の習得が不可欠です。 この記事では、大切ながら手間のかかる推敲を「効率的に」実施する方法を紹介します。ほとんどはじめて論文を書くことになった学生さんが、論文原稿（卒論・修論）の価値を飛躍的に向上させるうえで役にたちます。また、論文に限らず、「正しく、詳しく、丁寧に伝えたい」という気持ちで文章を書こうとする場合には、さまざまな場面で使えるはずです。 この記事で紹介する推敲の手段は、「切り分ける・並び替える・繋ぎ方を変える・削り落とす・一貫させる・まとめる・明確にする・限定する・やさしくする」の９種類です。この９種類さえ自由自在に駆使できれば、論文の文章を劇的に良くすることができます。この９種の推敲を、「まず工事して、片付けて、最後に気遣い
質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
「事実」と「意見」をキッチリ区別したいなら「主語を意識せよ」と、私は出版社で教わった。
もう随分昔の話なんですが、とある出版社さんにお世話になって、ゴーストライターっぽい仕事をやっていた時期がありました。 ゴーストライターといっても 「芸能人や有名人の代わりに単著を書く」というような華々しい仕事をしたことは一回もなく、 単に「誰かが、何かの事情で予定通り書けなくなった時、穴埋めに何か急いで書く」 というのが主要な役割だったのでそう呼ばれていただけなのですが、書くだけならとにかく色々書きました。 行ったことがない場所の旅行記を書いたことも、連載ものの時代小説の途中一回だけを書いたこともありました。 連載もの小説の途中だけを書くというのは自分でも割と面白く、書きながら 「これ、俺が登場人物全員切腹させたら来週どうなるんだろうなー」 とかよく妄想してました。まあ普通に考えて、それ実際にやったらめっちゃ怒られてボツになるだけでしょうけど。 ちなみにこの時は、プロットすら何も渡されてい
エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita
はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、亀の甲より年の劫とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿のテーマは、「主に設計書を想定した、開発ドキュメントの書き方」です。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな（≒納品物になりえる）設計文書、です。 したがって、自社サービス開発よりも受託開発、アジャイルよりもウォーターフォール、を前提として読んでいただいた方が、しっくりくると思われます。 ＜ご注意＞ 本稿の内容は執筆者独自の見解であり、所属企業における立場、戦略、意見を代表するものではありません。 個人的に心がけていること 当該文書の作成目的や位置付けを冒頭に記載する
「という」と「こと」を減らすだけで、文章はぐっと読みやすくなる｜Ryo Yoshitake | THE GUILD
と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記：第二弾？書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった！ （よりによってこれか……せっかくなので皆さんスタァライトを観ましょう！） 記事中では
読点の打ち方―原則は１０パターン
読点には絶対というような法則がありません。そのため、書き手の感覚に任されている面があり、実際、プロの文章を見ても、読点のやけに多い人から少ない人までさまざまです。とはいうものの、読点をつけるための原則というものはあります。 次に、出版界などで目安となっている読点の打ち方を１０項目ににまとめて紹介します。 ①接続助詞（ば・から・ので・て・が・のに・けれど・ても・し…など）のあと 私はダイエットしても、さっぱり体重が減らない。 ②独立語（ああ、はい、もしもし、ねえ…など）のあと ねえ、いっしょに行ってくれないかしら。 ③接続詞（そして、しかし、なお、また、ゆえに、ちなみに、さて…など）のあと そして、誰もいなくなった。 ④同じ役割の動詞、形容詞、副詞などが並ぶ場合 明るく、風通しのよい部屋ですよ。 彼はこぶしを上げ、叫んだ。 ⑤時、場合などを表す前置き文のあと（文全体を限定する場合） 私たちが
要約のコツを教えてくれるPDF見つけたよ: うらおもて人生感。
・要約のすすめ 読売新聞の記者代ゼミの国語科の土生さんが書いた要約のコツ。非常に読みやすい。 ※矢吹さん、訂正のご指摘ありがとうございます。 ・要約の基礎徹底 38ページもある徹底した要約講義。 軽妙な語り口でホイホイ読めちゃいます。ばっちり演習問題もある親切設計。 無料でこのクオリティは驚きの一言。 ※PDFに直リンしているので、ご注意を。 ＋0723 追記 7/22に「要約の基礎徹底」の著者、矢吹芳裕さんがツイッターで当記事をご紹介いただきました。ありがとうございます。 感謝を込めて、ここで矢吹さんの運営されているブログとwikiをご紹介します。 こちらも要約、ひいては文章書きにヒントを与えてくれる内容です。おすすめ。 僕は昨日と今日で、Garbage Out!!とwikiは読んじゃいました。すぐに読めちゃう筆致がプロい。 ・Garbage Out!! 広く文章の書き方を教え考えさせて
文書品質の向上と文書作成時間の短縮：｢考えが文にまとまらない」を解決するためのテクニカルライティング
<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">考えが文にまとまらない<
ココカラハジマル : 私家版「雑誌原稿書き方＿全111条」
本稿の改訂版をnoteにアップしています。項目別に整理しているので見やすいです。下のリンクで最新版をご覧ください https://note.com/cabanon/n/n379c454aad4f 昨日の【雑誌原稿書き方基礎講座】で使ったKeynoteに書いていたことを改変・再編集してアップします。全111条。僕が個人的に積み重ねてきたノウハウです。ライターだけでなく編集者としての心得も混じっています。仕事をしてきた出版社が違えば、このノウハウも違うものになったでしょう。だからあくまでも私家版です。デザイナーや建築家やアーティストや工学研究者の取材記事執筆を前提にした話であることをご了承ください。 ＊アップデート情報 ・全110条を全111条にしたり、第74条を追加して他を統合したりなど、こそこそ修正しているので、3/5にアップしたものとは少し変わっています（3/8記） ・95条の説明に奥義
13日間で「名文」を書けるようになる方法 - 情報考学 Passion For The Future
・13日間で「名文」を書けるようになる方法 高橋源一郎の明治大学大学院における「言語表現法」講義の書籍化。全13回の授業が学生とのやりとりを含めて収録されている。とてつもない名講義。言葉で語らず、インタラクションで考えさせるという高度な教授法を、毎回繰り出す。 初日、スーザン・ソンタグの「若い読者へのアドバイス」という名文が配られる。死期が近いことを悟った思想家が若者に向けて「心の傾注」という言葉をキーワードに真摯な忠告を短い手紙のように書きつづったものだが、「読み終わったら、その紙から目を上げ、窓の外を眺めてみてください。なんて美しい風景でしょう。このキャンパスのいいところは、こういうものが見られることです。すぐ横に、そんなに美しいものがあるのに、活字ばかり追いかけてはいけません。読んだものは忘れて、見ることに、傾注してください。」と先生。 オバマ大統領の演説、斉藤茂吉のラブレター、しょ
読みやすい文章の極意は「修飾語」にあり
「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 第5回「ドキュメントの質を確実に上げる6つの文章作法」に続き、顧客に伝わる文章を記述するためのポイントを紹介します。今回は、修辞句や用語など、「より具体的な表現方法」について説明します。なお、前回同様に、まず「分かりにくい例文」を取り上げてどこが分かりにくいのかを解説し、その後に分かりやすい文章へと修正していきます。 「修飾語を適切に使う」ことが、読みやすい文章を作るコツ 分かりやすい文章を書きたいなら、「修飾語」に着目しましょう。修飾語を使うときは、以下のような点に注意します。 長い修飾語は前に、短い修飾語は後に置く 文章を書く際は、句や文節を使った長い修飾語を前に、
デザイナー（と編集者）のための日本語力強化図書・選。 - 遠近法ノート
僕が属するエディトリアルデザイン／ブックデザインの仕事は、日本語を扱う仕事だと言っても過言ではありません。 ところがどっこい、デザインの世界に入ってくる人たちは、どうも国語力があやしい方が多かったりするんですね。グラフィックをやるつもりで来てるんだから、まあ分からんでもないですけど。 でもねぇ、普通、国語辞典の一冊くらい手元に置いておくもんでしょ。これは社会人としての常識ですよ。 ……ま、そんなわけで、デザイナーとか編集者とか、あるいはWeb・映像制作者のために、手元に置いておくとよい日本語関係本をいくつか紹介しちゃいます。 総合 社会人のための国語百科 カラー版 作者: 内田保男,石塚秀雄出版社/メーカー: 大修館書店発売日: 2004/03メディア: 単行本購入: 5人 クリック: 65回この商品を含むブログ (3件) を見る大修館書店の『社会人のための国語百科』。国語の参考書・大人版
わかりやすい技術文章の書き方
誰が読むのか。 読み手にどんな感想を持ってもらいたいか。 読み手はどれくらいの予備知識を持っているか。 読み手はどんな目的で、何を期待して読むのか。 読み手が真っ先に知りたいことは何か。 レポート・論文とは何か 問いが与えられ、または自分が問いを提起し、 その問題に対して明確な答えを与え、 その主張を論理的に裏付けるための事実・理論的な根拠を提示して、主張を論証する。 標準的な構成要素とは何か レポート・論文の構成は、 概要 序論 本論 論議 という要素が標準的である。次にそれぞれの要素について簡単に見てみる。 概要 論文全体を結論も含めて、すべて要約する。 序論 本論で取り上げる内容は何か。 その問題をどんな動機で取り上げたのか。 その問題の背景は何か。 その問題についてどんなアプローチを取ったのか。 本論 調査・研究の方法・結論 論議 自己の議論・結論を客観的・第三者的に評価する。 そ
正確な文章の書き方
このページでは、正確な文章を書くための秘訣をまとめてみようと思います。それほど文章がうまいとはいえない私が、文章の書き方について述べるのですから、むこうみずな行為であることは百も承知です。しかし、数年に渡って探求した正確な文章の書き方が、少しでもみなさんの役に立てばという思いを自分への励ましに代えて筆をとります。 ここでお話するのは、「文章をいかに正確に書くか」や「自分の考えをどうやったら適切に表現できるか」であって、決して「どうやったら人を感動させる名文句が書けるのか」ではありません。 このページを読んだら「科学技術文献」を書くための技術が少しは身に付くのではないかと期待しています。しかし、 人はいさ 心も知らず ふるさとは 花ぞ昔の 香ににほひける (紀貫之) などのような心に残る文章が頭に浮かぶようになるわけではありません。 絵の書き方に例えて言うなら、ここで述べる内容は、色彩や調和
人を惹きつけ人を動かす文章を書く方法 初心者にもわかるコピーライター養成講座 ～言葉で世の中を動かそう - プログラマーkkの勉強/成長ブログ@ライブレボリューション(モバイル広告�
先日、宣伝会議のコピーライター養成講座の特別体験講座を受けてきた。 そのまとめ。 目次 言葉で世の中を動かそう コピーライターへの道 課題 解説 宣伝会議のコピーライター養成講座の宣伝 この講座で得られること コピーライターが求められている理由 コピーライターにはどうすればなれるか・・・その決心と、努力 キョロキョロしよう・・・観る フムフムする・・・聞く ワイワイする・・・話す ムチャクチャする・・・熱中 ウンウンする・・・書く コピーライターのためのコラム 感想 参考書籍 最近書いたまとめ記事 言葉で世の中を動かそう コピーライターへの道 講師は、理論派コピーライターの谷山雅計氏。 まず最初に課題が出された。 課題 『古本屋を若者にもっと利用してもらうためにキャッチフレーズを書いてください』 15分で３つ書くように言われた。 全員分を回収し、30分後谷山さんが戻ってきた。 解説 なぜこ
『論文を書くためのWord利用法 ～文書も頭も構造化する～』
上山あゆみ 1963年 京都生まれ 1983年 少しでも悪筆を人目にさらす機会を減らすべく、ようやく普及し始めたパソコンを購入。ただし、Word はおろか、一太郎もまだ発売されていない頃だったため、なんとか簡単な自作プログラムで卒論を印刷できるよう工夫する。卒論は、「規定に、ペン書きで、と指定されていますので」とのことで、プリントアウト版の受理は却下されてしまったが、その頃から、言語学の研究のかたわら、時々、自分用のプログラミングをするようになる。 1985年 京都大学文学部卒業（言語学専攻） 1990年 京都大学大学院博士後期課程単位取得満期退学 1995年 この本で紹介している自動連番のマクロを使い始める。Word のマクロの体系が変わっていったが、このマクロプログラムの仕組みそのものは、当時から変わっていない。 1998年 南カリフォルニア大学博士号（言語学）取得 200
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
テクニカルライティングの基本
もし文章を読みたい部分だけ読みたい粒度で読めるようになったら、というアイデアがめっちゃ面白い「これすごいな」
http://yebisu.cc.kyushu-u.ac.jp/~watanabe/RESERCH/MANUSCRIPT/OTHERS/YOKO/ten.pdf