テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter:https://twitter.com/naoh_nak 2022年版(初版):https://speakerdeck.com/naohiro_nakata/technicalwriting
![テクニカルライティングの基本 2023年版](https://cdn-ak-scissors.b.st-hatena.com/image/square/f73a4e161eba2f2c70fcf08899c88c585382ddaf/height=288;version=1;width=512/https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2F6d29f16691a1401495d18b7fea44b85b%2Fslide_0.jpg%3F26087129)
先日、東洋経済さんでこんな記事を拝読しました。 「作文」が書けない子に教えたい3つの言葉 文章を書くことは、観察し、驚きを見つけ、考えることです。これがステップ1からステップ3への手順に当てはまるのです。 (東洋経済オンライン) 正直なところ、この記事を書いた方は「作文が書けない子」のレベルをかなり高く見積もっているなあ、と感じました。 いや、文中のテクニック、文中の手法が悪い、というわけではないのです。ここに書かれていることは、それはそれで非常に有用、非常に有効なことだと思います。 「観察→深堀りと整理→考察」という思考法は、あらゆる表現、あらゆる論考で重要な手順です。 小さい頃からこの手順になじんでおくことはとても有益ですし、その際の教え方、かみ砕き方として、文中提示されているような言い方をするのも有効でしょう。そこについては何の文句もないんです。 ただ、ここでいう「作文が書けない子」
レポートを書く前に知っておくべきこと。 大学では、あなたが何を知っているかよりも、知らないことにどのように対峙したかが評価される。 これは、大学が知識を生み出す場である場所である以上、不回避なことである。 そして時間のスパンを少し長めにとれば、この基準は、知識を持っている者を評価することにもなる。 知らないことに真摯に対峙する者は、自分の今の知識にしがみつく者よりも、最終的にはよく知る者になるからだ。 しかしこれだけではあまりに抽象的だから、ノウハウのレベルに落としこむことを考えよう。 以下に、組織的に問いかけることで、大学の課題のレポートを作成する方法について説明する。 この方法はまた、文献を再利用可能な形で深く読むためのノウハウでもある。 マトリクスで問う 以前、文章を書くのがとことん苦手な人のための・・・という記事で「なか1・2→まとめ→むすび→はじめ」で考えるという、小学生のための
論文の書き方、9つのルールです。 これってブログ書くときにも使えそうです。 9つをちゃんと守れば良いブログが書けるでしょう。 (1)主張を書いて! (2)理由を書いて! (3)(構造化の)階層をそろえて書いて! (4)概要と詳細に分けて書いて! (5)一言で表現して! (6)抽象的な表現でなく,具体的に言って! (7)省略をしないで書いて! (8)事実と意見は分けて書いて! (9)論点を明確にして! 参考元 論文執筆ができれば10年後も通用する文章術をゲットできる – 発声練習 (1)主張を書いて! ブログを書く時にもつかえそうですね。 (2)理由を書いて! 何を書いたらいいのかわからない時にちゃんと構造化して書くことで読み手に伝わりやすそうです。 (3)(構造化の)階層をそろえて書いて! TOCというプラグインを使ってh2要素を読みやすいように構造化しています。 (4)概要と詳細に分けて
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く