Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
社内で行ったビジネスライティング講座資料を公開します | DevelopersIO
オペレーション部 江口です。 先日、社内でビジネスライティングについてオンラインで講義する機会があったので、その資料を公開しておきたいと思います。 いわゆる技術文書というよりは、メールやSlackなど、相手とやり取りを行う際の文章作成を主に考えた資料となっていますので、その点ご承知おきください。 背景 講義を行ったのは、アカウント周りの作業を行うアカウントチームに対してでした。チームの業務内でメールでの顧客とのやり取りやSlackでの社内でのコミュニケーションなど、文章を作成する機会が多く、その際の書き方に課題を感じている方が多いようだったので、少しでも助けになればと思いこの講座を企画しました。 私は別に人に自慢できるほど文章がうまいわけではないですが、約20年のエンジニアのキャリアで顧客とのやり取りや技術文書の作成などをそこそこの数こなしてきました。先輩や上司などからいろいろな指摘を貰い
ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ - Qiita
システム開発にドキュメントは欠かせません。ドキュメントが得意になれば活躍の幅が大いに広がりますよね。 この記事では、まず冒頭でドキュメントの作成に求められると思うことを整理した上で、そのスキル獲得に役立つと思われる記事や書籍を集めてみました。もちろん他にもあると思うので、もしお薦めのものがあれば是非コメントで教えて下さい 更新履歴 ・2021/04/16：文章術系にリンクを追加しました。 ・2020/11/28：文章術系にリンクを追加しました。 ・2020/07/24：文章術系にリンクを追加しました。 ・2020/05/24：文章術系にリンクを追加しました。 ・2020/05/14：スライドデザイン系にリンクを追加しました。 ・2020/04/29：スライドデザイン系にリンクを追加しました。 ・2020/04/17：文章術系にリンクを追加しました。 ・2020/04/12：関連するTwit
実用文で「起承転結」はNG！ 伝わりやすいテクニカルライティングを実践する4つのコツ：CodeZine（コードジン）
相手に伝えるための文章には工夫が必要です。特に領域を問わず技術に関することをわかりやすく伝えるのは簡単ではありません。では、技術文書を書くテクニカルライティングにはどんなコツがあるのでしょうか。翔泳社の『技術者のためのテクニカルライティング入門講座』から4つ紹介します。 本記事は『技術者のためのテクニカルライティング入門講座』から内容を抜粋し、掲載にあたって一部を編集したものです。 そもそも「論理的」とはどのようなことか 「論理的」とは、筋道が通っていること わかりやすく伝わり、読み手の次の行動につながる文章は、「論理的」に書かれています。「論理的」を一言で説明するなら、「筋道が通っていること」と言えます。 「道案内」を例に説明すると、筋道が通っている場合は目的地まで迷わないように進むべき道が示されています。筋道が通っていない場合は、あちこちに余分な説明があり、行きつ戻りつと遠回りして目的
【美文字】履歴書やノートが劇的に変わる！誰でもスグにできる、手書きの名前や文章を美しく見せる3つのコツ│タウンワークマガジン
あなたは、美文字が書けますか？ 字が汚いだけで、あなたの印象は悪くなってしまいます。試験勉強の時期、ノートをお友達に貸したところ「読めない」なんて言われたら、ショックですね。 あるいは、履歴書を書くときやバイト中にも、字がキレイなほうが恥をかかずに済みます。 実用美文字コンサルタント・谷口栄豊 先生によると、以前紹介した以下の3つのポイントに気をつけるだけで、あなたの字が美文字に見えるといいます。 これは基本です。 そして今回は、1文字ずつの「美文字の書き方」ではなく、名前や文章を美しく見せるコツを教えていただきました。 ポイントは、全体をバランスよく魅せることなのだそう。 1．画数の多い字は大きく、画数の少ない字は小さく 下の2つの履歴書の「名前」、どちらが好印象ですか？ 上ですよね。 「田」や「子」のように画数の少ない字は小さく書くと、バランスが良くなります。逆に「藤」や「優」のように
文章力を上げる方法｜上手い文章の書き方や文章構成が学べる7つの記事と参考本
この記事では、現代において誰もがブログやSNSを通じて意見や考えを発信できる時代にあって、読まれる文章とそうでない文章の差が明確になってきていることを指摘しています。良い文章を書くための方法論やポイントが紹介されており、プロの知恵や知識が集約された文章力向上のコツが提供されています。また、文章力の定義や読みやすい文章の構成法、効果的な文章テンプレートなどが解説されており、あらゆるジャンルの文章作成に応用できる基本的な考え方を学ぶことができます。 そもそも、文章力とは そもそも、文章力とはなんなのかを考えてみましょう。 結論からいうと、「だれが読んでもわかりやすく、読みやすい文章を書く力」のことをいいます。 ただし、文章力の定義は「その文章が誰に対して書かれたものなのか」や「文章を書いている場所（ブログやSNSなど）」によって違います。 例えば、オピニオン記事（特定の事象に対して個人の意見を
相手に伝わる論理的な文章を書くための３つのテクニック - 自由日記
2013-10-14 相手に伝わる論理的な文章を書くための３つのテクニック 雑記 基本的に文章は人に伝えるために存在する。だけれど自分だけが理解できる文章を書いている可能性も否定できない。文章は読んでもらってこそ意味があり、読んでもらうには論理的で相手が読みたくなる文章を心がける必要がある。長めの文章を書くときは、事前に構成をある程度決めておくことで、論理的な文章を書きやすくなる。 「序論」「本論」「結論」の３つの構成で書くのが一般的で、「序論」は文章の導入部分、「本論」は核となる話、「結論」はまとめや伝えたいことを書く。 読みやすく論理的な文章を書くためには、これが基本となる。 1主張と根拠 「主張と根拠」は、最初に書き手の意見や想いなどの主張を述べ、そのあとにその根拠を説明していくというテクニックである。 「私は○○だと思う」⇒「なぜなら～だからだ」という文章の流れになる。 し
もう迷わない！「」『』（）【】の“使いどころ"／テクニカルライターが教える、文章の見た目を良くする技術 | きんどるどうでしょう
こんにちは、もう覚えていただけましたでしょうか、晴海まどかです。「テクニカルライターが教える、文章の見た目を良くする技術」第3回。 今回は、記号の使い方で文章の見た目をよくできないか考えます。記号の中でもちょっと迷うかもしれない、括弧のお話を中心に。ちなみに、今回の話に関して言えば“縦書き”・“横書き”の区別はあまりありません。 前回の記事はこちら：テクニカルライターが教える、文章の見た目を良くする技術「あなたの縦書き文書を美しくする数字の書き分け方」 *この記事はKindle作家の”晴海まどか”さんからゲストポストいただきました 「括弧」を極めて美しい文章を作る技術 まずは例文をば！ 今回は先に例文を一つ見てみましょう。 なーんとなく、読みにくくないですか？ 以降、記号の使い方によって見栄えがどう変わるか、考えてみます！ 記号の代表格、括弧の使い方 括弧と一言で言っても、「かぎ括弧」（丸
デートの誘い、プロポーズの断り……手紙でどう伝える？ 郵便局が公開する「お手紙文例集」 - はてなニュース
プロポーズを承諾するとき、手紙でどんな返事を書けばいい？ 郵便局のサイトで公開されている「お手紙文例集」の内容が、はてなブックマークでじわじわと話題を呼んでいます。「デートの誘い」「プロポーズの断り」といった縁談・恋愛から、「働き過ぎの人」に対する忠告・助言まで、そのシチュエーションはさまざまです。 ▽ プライベートの文例 文例一覧（縁談・恋愛（往信、返信）） - 日本郵便 郵便局のサイトでは、ビジネスやプライベートで使用できる手紙の文例をまとめたコンテンツが用意されています。はてなブックマークで特に注目を集めているのは、プライベートで使える「縁談・恋愛」向けの文例。「デートの誘い」から「見合いの相手からの結婚の申し込み断り」まで、19の文例が紹介されています。 例えば「デートの誘い」では、「会社ではなかなかプライベートなお誘いはしにくく面と向かうと照れくさくて言い出しにくいので、手紙に書
英語での仕事の依頼メールに適切な返答が欲しい人に守ってほしい書き方のルール - World Wide Walker
英語での仕事の依頼メールに適切な返答が欲しい人に守ってほしい書き方のルール Posted by yoosee on English at 2013-03-30 13:43 JST1 英語業務メールの主な構造と特徴仕事柄、日本からのメールに目を通す事が多いのだが、現地社員や関連会社への依頼がうまく通じずに苦労しているのを見たりフォローせざるを得なくなったりすることが少なくない。英語能力自体の問題や仕事の理解の問題などについては上達してもらうしか無いのだが、仕事のやり取りの流儀的な所で引っかかっている人もしばしば見かける。その辺を踏まえ、英語で仕事をする人向けに英語の依頼メールを書くコツを少しまとめてみた。なにかしらの参考になれば幸いだ。 メールの構造 メールの主題・依頼内容は、理由は後述するが1通のメールに1つに絞る。メールの構成は概ね以下のようなものになる。 Subjectに特定しやすく分
文章のプロ直伝！素人でもプロ並に書けるようになる５つのテクニック
ユーザーに届ける価値を徹底的に追求する マーケティングを提供します © Copyright 2022 バズ部. All rights reserved. 文章力は、ビジネスの世界で、今まで以上に非常に重要なスキルとなっている。 例えば、広告やダイレクトメールなど、消費者に向けてのメッセージは文章力に大きく依存する。 また、興味のある人に対してコンタクトを取って、アプローチする際も、あなたの書くメールや手紙などの文章の内容によって、成否は大きく左右される。 思い返せば、私は、社会に出る前の学生の頃から、大学で、大量の本を読み、週に２〜３本のエッセイを書いたり、レポートを提出したりしていた。 そして、こうやって培って来た文章力によって、ビジネスにおける様々な面で得をしていることを実感している。そこで本日は、私が実際に使っている文章テクニックを５つご紹介する。 この通りに書いて頂くだけで、プロの
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
読みやすい文章を書くための効果的な11の工夫。「頭がいい人の文章の書き方」 : まめストリート・ジャーナル 〜無料で情報が買える唯一の新聞〜
2012年10月16日22:52 by tkfire85 読みやすい文章を書くための効果的な11の工夫。「頭がいい人の文章の書き方」 カテゴリ管理人 雑談 tkfire85 文章をうまく書きたい。そう思う人は多いです。頭がいい人の文章の書き方 (イラスト図解版)posted with ヨメレバ日本語倶楽部,小泉 十三 河出書房新社 2008-11-22 Amazon楽天ブックス図書館でも自分には無理だろう、そう思って挫折する人が圧倒的な多数です。でも、ちょっとした工夫で文章が見違えるように変わったらどうてしょう。文章というのはある意味で気配りだと思っています。少しでも読みやすい文章。伝えたい文章を書く事で、文章がより読みやすくなります。今回は、そんな文章術の工夫を「頭がいい人の文章の書き方」の中から、文章を書くための効率的な工夫を紹介してみょうと思います。 ●読みやすい文章を書くための効果
反応が取れるブログの書き方〜たった4つの基本文章テクニック〜
１．マクスウェル・サックハイムの三原則マクスウェル・サックハイムは１９００年代前半に活躍した敏腕広告マンだ。広告業界、コピーライティング業界に大きな影響を与え、マクスウェル・サックハイム賞という賞も出来ている。受賞者には、例えば「滑り台効果」で有名なジョー・シュガーマンがいる。 さて、マクスウェル・サックハイムの三原則とは以下のようなものだ。 この三原則は、広告/コピーの業界にいる人間なら、誰もが知っているほど有名なものだ。そして、優れた文章には、この三原則を乗り越える力がある。 それでは、この三原則を乗り越える文章を書くには、どうすれば良いのか？一つずつご紹介する。 １−１．Not Read（見ない）を乗り越える方法Not Readを乗り越えるためには、一目で中身を読み進めたいと思ってもらえるようなキャッチコピーが必要だ。ここでいうキャッチコピーとは、ブログならブログタイトル、メールなら
文書品質の向上と文書作成時間の短縮：｢考えが文にまとまらない」を解決するためのテクニカルライティング
<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">考えが文にまとまらない<
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
心に残る文章を書くための修辞技法 - RyoAnna
心に残る文章が書きたい。感動が伝わる文章。数年後に読んでも違和感のない文章。 楽しい、美しい、嬉しい。形容詞は素直に思いを伝える事ができるが、時間が経つと色あせる。 心は変化するからだ。 2011年に書いた記事を振り返りながら、修辞技法の効果について説明したい。 列叙法・史的現在 列叙法 ある特定の対象に対して、関連性のある単語や文章を、立て続けに並べて強調する手法。 史的現在 過去の出来事を、今行われているかのように書き表す手法。 渋谷で発生した人身事故の影響で、代々木のホームから電車が発車しなかった。ドアが開いてるせいで、車内の冷気が外へ逃げ、空調がごうごうと音を立てる。目の前に座っている女の子たちは、お菓子を食べながら延々と他愛もない会話をしている。首筋から汗が流れ、いよいよ諦めて車内から出ようとした矢先、運転再開のアナウンスが流れた。意気揚々とした声だった。 原宿の喧騒とAppBa
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
【文章術】『１５０字からはじめる「うまい」と言われる文章の書き方』高橋フミアキ : マインドマップ的読書感想文
１５０字からはじめる「うまい」と言われる文章の書き方 【本の概要】◆今日ご紹介するのは、久しぶりに文章術の本。 先日某リアル書店で平積みで大展開しているのを見て、思わず買ってしまいましたｗ アマゾンの内容紹介から。手紙・ブログ・メールから作文・自己PR・小論文・報告書まで…ニガテだった文章がみるみる書けるようになる10の文章パターンと48のテクニック。本当に書けるノウハウ満載。短文から長文まで、パターン満載で勉強になりました！ いつも応援ありがとうございます！ 【ポイント】■1.説得力が増す「承認の文章」 危機感をあおったあと、ダイエットに失敗した消費者を「承認」してあげる(受け入れる)文章を書くのです。「わたしもダイエットに何度も失敗したことがあるので、あなたの気持ちはよくわかります。あなただけじゃありません。みんな失敗経験があるんですよ。大丈夫。あなたもきっと美しい体形になれます」とい
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
インフラエンジニアの綺麗で優しい手順書の書き方
