テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter:https://twitter.com/naoh_nak 2023年度のアップデート版もあります:https://spe…
書けない。 最初の一行に呻吟し、次の段落で懊悩し、そこから先が続かない。あるいは、言葉が詰まって出てこない。「これじゃない」言葉ばかり並んでいる。支離滅裂の構成で、書いても書いても終わらない。 そんな悩みを抱えた4人が集まって、お互いの「書けない」病をさらけ出す。学者、文筆家、編集者と、書くことが仕事みたいな人なのに、書けない悩みを打ち明ける。 「書けない」ことへの生々しい告白の中で、まるで私のために誂えたような手法や、まさに今、自分が実践しているやり方が紹介されている。 書かずに書く 千葉雅也さんが喝破してたこれ、まさに私が今やっている 「ファイル」→「新規作成」で、新しい白いページを表示させ、そこに一行目から書き出す……なんて執筆は、しない。そんなことすると、白いワニが来る(by 江口寿史)。 書かずに書く、って禅問答みたいだけど、言い換えるなら、「書く」というプロセスが始まった時点で
短いメッセージを書くことはできても、まとまった文章を書くのに苦労している人は多いのではないでしょうか。 この記事では、まとまった文章を作るときの技術を学ぶことができる記事や学習コンテンツを紹介します。新人エンジニア向けです。 文章の「型」を学ぶ まとまった文章を書くには、「型」が必要です。頻繁に使うものは、「型」を覚えてしまいしましょう。 バグレポートの書き方を学ぶ エンジニアとして書く文章の代表例が、バグレポートです。 バグレポートでありがちな失敗として「何が問題だと思っているのか」が伝わらないというものがあります。 これを防ぐために、「期待する結果」「実際の結果」「再現手順」の3つを必ず書くようにしましょう。 質問の書き方を学ぶ エンジニアが扱う技術は、最初はわからないことだらけです。 それを解決するために、質問の文章を作成する技術が必要となります。 概ね下記の4つの情報があれば、良い
いまちょうど『文章力が、最強の武器である。』という本を読み終えたところです。 これで、ついに出そろいました。 長らく追い求めていた「文章力」の理想郷。 どうやらそこには、4人(冊)の四天王がいらっしゃったようです。 これまで「文章力」「文章術」「書き方」と検索して、約20冊近く読んできました。 その中から選び抜かれた四天王をご紹介します。 入門編『文章力が、最強の武器である。』藤吉 豊 https://amzn.to/3njBbiF 最初に四天王の1人目、入門編で待ち構えているのがこの『文章力が、最強の武器である。』。 まず何と言っても、章立てがすごく魅力的なんですよね。 第1章は、文章力が劇的に上がる「3つの視点」。 おもしろい わかりやすい 読みやすい この3拍子が揃った文章こそが、「良い文章」なのだと筆者は語っています。 その後、先ほどの3拍子それぞれを伸ばしていくための考え方・型・
中村明博(編集者) @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、! 中村明博(編集者) @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 中村明博(編集者) @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人」あたりの表記統一を行う このあたりまで見ていただけると、編集者はみな泣いて喜び
書くことは思考すること ピューリッツァー賞受賞の歴史学者デヴィッド・マカルー(David McCullough)は、ライティングについてこんな言葉を残しています。 Writing Is Thinking. To write well is to think clearly. That’s why it’s so hard. 書くことは思考することだ。うまく書くことは、明瞭な思考力をもつこと。だから難しい。 頭の中で想像していることをうまくアウトプットできない場合があります。ライティングはもちろんデザインでもよくあることです。頭の中では良い感じにまとまっていることでも、アウトプットしてみると「なんかは違う」という経験は誰でもあると思います。 デザインの場合、スケッチしたりデザインツール上で模索するなどアウトプットの量を増やすことで次第に思考とデザインのギャップを埋まります。同様にライティング
と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記:第二弾?書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった! (よりによってこれか……せっかくなので皆さんスタァライトを観ましょう!) 記事中では
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く