テクニカルライティングの基本 2023年版テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting
意外と知られてない、すごく効果のある文章上達法｜ふろむだ@分裂勘違い君劇場
文章上達法について、「大量に書け」派と「大量に読め」派の人がいます。 「ひたすら大量に文章を書け。文章上達にはそれしかない」というのは書け派の典型。 「まずはラノベを千冊読め。話はそれからだ」というのは読め派の典型。 しかし、大量に文章を書いているのに文章の下手な人はたくさんいますし、 ラノベをたくさん読んだけど面白いラノベの書けない人もたくさんいます。 これはスキル全般に言えることで、 たとえば、アメリカに二十年住んでいるのに英語がいまいちな人なんて、いくらでもいます。 「量をこなせば自ずと質に転換する」のは、もともと才能のある人間だけです。 私のような凡才は、量をこなすだけでは効率よく上達しません。 質の高い修練を大量にやってはじめて、効率よく上達するのです。 では、質の高い修練とはどういうものでしょうか？ それは、次の２つです。 (1)優れた文章のどこがどう優れているかを、文章を書く
読み書き能力が身につく、読書感想文や日記の書き方
最近は出番がなくなってきたけれども、一時期、子どもの読書感想文や日記について相談を持ち掛けられる……というより困っているのを見つけて助け舟を出しがちな状況があった。 ありがちパターンはこうだ：週末、「宿題は終わった？」と訊ねたら「だいたいやってある」と子どもが答える。うんうん、感心感心。ところが日曜日の午後８時ぐらいに「日記がまだ書いてない」という言葉が聞こえてくる。さあどうしよう。日記のネタを探すところからやらないと……といった具合だ。 読書感想文の場合は、週末の初め頃に何を読むべきか悩んでいたり、「読んだはいいけど何を書けばいいのか困っている」と子どもから耳にすることが多い。 私の子どもは21世紀生まれなので、一定程度は本を読むにせよ、私自身の幼児期に比べれば本を読んでおらず、そのぶんオンライン上のドキュメントを読んでいたり動画を見ていたりする。 それは別に悪いことではないが、本の読解
読みやすいドキュメントを書くために今日からできる7つのこと｜壮｜Masato Tanaka
こんにちは。壮（@sew_sou19）と申します。 メガベンチャー企業でエンジニアとして働いています。 エンジニアにジョブチェンジした当初は、ドキュメントの書き方なんてこれっぽっちも分かりませんでした。読みやすいドキュメントを書くことが本当に苦痛だったのですが、考えて、試行錯誤し続けた結果、以下のような評価を得るに至りました。 リーダーから「君は情報の整理が上手でドキュメントが本当に読みやすい。チーム全体の能力向上に繋げたいからドキュメント書く際のポイント共有してほしい」と言われたので、意識していることを言語化しつつテクニカルライティングの本でインプットしてるけど、学びが多い。ついでにnoteにもまとめてる — 壮 (@sew_sou19) November 28, 2022 そこでこのnoteでは、僕がドキュメントを作成するときに、特に意識して実践している7つのことを書きます。（本当は2
果てしない文章推敲を「３ステップ」で効率的に終わらせる方法｜石原尚（大阪大学教員）｜note
文章は、「これで伝わるだろう」という淡い期待を簡単に裏切ります。伝えたいことを期待通りに伝えられるようになりたいのなら、「表現の質」を高めるための推敲の技術の習得が不可欠です。 この記事では、大切ながら手間のかかる推敲を「効率的に」実施する方法を紹介します。ほとんどはじめて論文を書くことになった学生さんが、論文原稿（卒論・修論）の価値を飛躍的に向上させるうえで役にたちます。また、論文に限らず、「正しく、詳しく、丁寧に伝えたい」という気持ちで文章を書こうとする場合には、さまざまな場面で使えるはずです。 この記事で紹介する推敲の手段は、「切り分ける・並び替える・繋ぎ方を変える・削り落とす・一貫させる・まとめる・明確にする・限定する・やさしくする」の９種類です。この９種類さえ自由自在に駆使できれば、論文の文章を劇的に良くすることができます。この９種の推敲を、「まず工事して、片付けて、最後に気遣い
【なるべく意識を低く保て】 書けないと悩む人のための、原稿の書き方 ： 〜雑誌原稿を実例に〜｜ふくろう
この記事は、執筆業を15年（専業5年／副業10年）ほど続けている人間が、どのように原稿を書いているかを解説する、執筆メイキング記事です。 私が2年、寄稿していた『本の雑誌』新刊レビュー原稿を例として、初稿から完成稿までどのようにバージョンを重ねているか、説明します。 ◆【前置き】この記事を書いた背景◇想定読者想定読者は、「原稿をなかなか書き出せない人」「原稿を書くのに時間がかかる人」「原稿を思うように書けずに苦悶している人」です。 ◇きっかけもともと本稿は、執筆に悩む家族のために書いた、家庭内閲覧用の文書です。 家族（執筆の専業経験なし）は、たまに専門領域の記事や書籍の執筆依頼を受けて書いています。執筆するたびに「書けぬ……書けぬ……もうだめだ……」とうめきつつ、どうにか書き上げるのが風物詩でしたが、今とりかかっている原稿はとりわけ難産らしく、毎日「何の成果も！得られませんでした！！」状態
伝わる文章 | 基本要素 | SmartHR Design System
相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況（読む場面、事前知識など）を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1：法律や業務に関わる記事目的業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before日本の年金制度は、全国民
スケベ小説を書くときの参考書・ツールまとめ
喚く狂人 @wamekukyouzin コミケで「スケベ小説を書くにあたって使っている参考書」みたいな話をしてたら、「それTwitterに書いてまとめたら？」という話になったので、色々紹介していきます。 2022-01-01 23:31:21 喚く狂人 @wamekukyouzin 文が読みづらいと「使いづらい」ので、なるべく分かりやすくしたいです。そこで本田勝一「日本語の作文技術」。 修飾語の順序であったり句読点の使い方について体系だって解説するベストセラーです。エロに限らず趣味で小説を書くなら是非読むとよいと思います。 ただし例文の政治的思想が強いです。 2022-01-01 23:31:42
ライティング力が勝手に上達する「写経」
文章が上手になる方法 「文章」や「記事」を書くことが苦手な方は是非参考にしてください。 「文章を書く」と聞いただけで諦めてしまう方が多いのも現実です。 そもそも「文章を書く」事が苦手な方の原因ははっきりしています。 はっきり言いますが、原因は「練習してない」からです。 「では、今までに文章を書く練習をどのくらいしましたか？」 ほとんどの方が「やっていない」と答えます。 書けないのではなく、やっていないだけです。 文章を上手になる方法は「書いた量＝実力」と言うことです。 つまり、書けば書くほど上達します。 更に、ほとんどの人が「練習していない」のです。 今から始めても全く遅くはありません。 文章が溢れるトレーニング 「文章が上手くなりたい」 そんな方には「写経」をお勧めします。 「写経」とは「好きな文章そっくりそのまま書き写す」作業です。 句読点やスペースも全く同じように写してください。 手
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介しています。 どれくらい大評判だったかというと、2日間4セッションでしたが、エントリー数はのべ1000人を超え、実際の参加人数はのべ約900人。アンケートの回答は以下のとおり
Amazonの従業員が学ぶ伝わる文章構成の極意｜Sangmin Ahn
こんにちは、Choimirai School のサンミンです。 【主要なアップデート】 （2020.05.11）Blitzscaling、ビル・ゲイツのコメントと英語版リンクを追加 （2020.05.11）知的生産の技術に関するコメントを追加 0 はじめに ▲アマゾンの社内プレゼンテーションで、パワーポイントの使用が禁止されているのは、かなり有名な話。 会議では、冒頭のおよそ15～20分間、参加者全員にドキュメントを読むための時間があてられる。ドキュメントは６ページと長い場合も多く静まったミーティングルームで参加者が黙々とドキュメントを読む雰囲気はかなり緊張感が漂っている。 その後、基本的にはページごとにドキュメントの提案者が出席者からの質問に答えながら、さまざまなフィードバック、アドバイスを通して議論を重ねていく。 アマゾンの社内プレゼンテーションで、パワーポイントの使用が禁止されてい
小学2年生の次女が、サクサク作文の宿題をこなせるようになった「技術」についての話。
次女に作文の書き方を教えてみました。 以前も書いたんですが、長男長女次女が通っている小学校は、そこそこ宿題の量が多い小学校でして、低学年から割と計画的な宿題実施が求められます。 まだ幼稚園とそれ程変わらないような時期にあんまりタスク詰めるのもどうかな、と思う一方 「計画を立ててそれを実施する」 「計画が上手くいかなかったときのリカバリ方法を考える」 という経験が早い内から出来るのは悪くないかなと思って、ちょこちょこフォローしつつ様子を見ていたんです。 で、最近ぼちぼち小学二年生の長女・次女にも「作文」の宿題が出るようになりまして。 何かのイベントの振り返りとか、遠足の思い出についてとか、原稿用紙の前でうんうん唸る機会が段々増えてきたんです。 皆さん、子どもの頃作文って得意でした？400字詰め原稿用紙って、子どもの頃はめちゃ広大に見えましたよね。 今になって振り返ってみると、「これ早口系本気
「という」と「こと」を減らすだけで、文章はぐっと読みやすくなる｜Ryo Yoshitake | THE GUILD
と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記：第二弾？書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった！ （よりによってこれか……せっかくなので皆さんスタァライトを観ましょう！） 記事中では
簡単に真似できる文章上達術｜ベイジ社内勉強会資料
2019年3月26日に社内で実施した文章力をアップするための勉強会の資料です。プロのライターのようなハイクオリティな文章ではなく、ビジネスパーソンが仕事をする上で最低限機能する上での「上手な文章」を、とても簡単な3つに絞って話をしています。実際の勉強会ではワークもしてもらいました。皆さんもこれを読んで、実際に手を動かして自分の文章を添削してみてください。
エンジニアのための、いますぐ使える文章校正テクニック - ICS MEDIA
ウェブ制作や開発の仕事で文章を扱う機会は多いはず。書き手は不自然に思っていない文章でも、読み手は違和感をもっていることがあります。文章校正テクニックを覚えるだけでおかしな表現は少なくなり、読みやすい文章を書けるようになります。 本記事では、ICS MEDIAで実践している文章校正の一例を紹介します。 レベル1、基本的な校正ルールを使う いろんな場面で使える基本的な文章校正テクニックから紹介します。 テクノロジー系の名詞は正しく記載しているか テクノロジー系の名詞を間違って使うと、「本当に技術に詳しいの？」と読者からの信頼度が下がります。名詞は大文字小文字、スペース有無含めて正確に記述しましょう。 Github → GitHub（Hは大文字） Javascript → JavaScript（Sは大文字） After Effect → After Effects（複数形の「s」を忘れてはいけな
編集者が見る「わかりやすい文」を書く方法。たった一つのことをやるだけで劇的に変わるらしい「わかりすぎて心が痛い」
澤山モッツァレラ @diceK_sawayama ■編集者が見る「わかりやすい文」を書く方法 ・骨格となる論旨を箇条書きする ・それをガイドに書き始める ・一旦、思うがままに筆を走らせる ・一通り終えたら以下の通り推敲する ・形容詞を削る ・形容詞を削る ・形容詞を削る ・形容詞を削る ・形容詞を削る 劇的にわかりやすくなります。ぜひ 2018-09-05 00:21:48
【ライティング】高学歴こそハマる！読みづらい文章の特徴＆解消法
『この記事5、6万PVはカタいな…』 そんな力作がだだスベりした経験ないですか？ 何時間もかけて書いた長文が全然読まれないとやる気がなくなりますよね！ 読まれる記事を書くために、このブログでも『ネタ出し』や『記事構成』のノウハウを紹介してきました。 しかし、せっかく『コンテンツの質が高い』記事を書いても、読みづらければすぐに離脱されてしまいます。 そこで今回は、初心に戻って『読みやすい文章の作りかた』についてまとめていきます。 ”読みづらい記事の例”には、以前いただいたミドノンさんの寄稿記事を引用させてもらいました！（了承済み）
読まれるテキストは読者へのおもてなしの構造を持っている - mizchi's blog
大学生だった当時、梅田望夫の本を読んではてなにやってきた僕は、ブログ論壇への憧れだけがあって、技術者にもなれず、時流のテーマに対して書くべきテーマを持たず、ただ実家の宗教に対する恨みだけを書き綴っていた。 もちろん、そんなものを好きこのんで読む人はいなくて、ただ虚無へとテキストを放り込んでいたのだけだど、いつからか、ある程度パターンを獲得して、その真似をするようになって、成功失敗を繰り返して、それなりにPDCAを回してきたと思う。思えば、その過程でいろんな人のヘイトを買った気がする。 人間のテキストの読み方、その反応、というのはパターンを、いくつか書き起こしてみる。 読者は、ファーストビューのレイアウトで、読む読まないを決める タイトルは記事の印象の5割 章タイトルが残りの半分 本文はほとんど読み飛ばされる 書き手としては単語の印象の連なりでイメージを形成することになる 段落が均等に分割さ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
技術をわかりやすく伝えるためテクニカルライティング
テクニカルライティングの基本
