技術をわかりやすく伝えるためのテクニックとしての「テクニカルライティング」を学べます。Developers Summit 2023の登壇資料。開発者・エンジニアの方向け。 https://twitter.com/naoh_nak
![技術をわかりやすく伝えるためテクニカルライティング](https://cdn-ak-scissors.b.st-hatena.com/image/square/bd16fe674a032bbb3f8d1e8869a9d6959e4f8cff/height=288;version=1;width=512/https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2Fd0be189ad7454885ad5c99657ad336a2%2Fslide_0.jpg%3F24445424)
相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況(読む場面、事前知識など)を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1:法律や業務に関わる記事目的業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before日本の年金制度は、全国民
「概念設計と詳細設計は違うよ」 「概念設計で着目する場所は、不確実性(実装の不確実性と、マーケット評価の不確実性がある)が最も高い場所だよ」 「概念設計をやってる場で、詳細設計の話をされても困る」 という感じで自分の中では落とし込めたhttps://t.co/OlBZIwcs3R — ところてん (@tokoroten) October 3, 2022 「アート」と「構造」という対立軸はミスリードで、 「概念設計」と「詳細設計」なんだわコレ 詳細設計しかやってなくて、概念設計の経験が無い人には、概念設計は自分にはよく分からないアートに見えてしまう、という話 — ところてん (@tokoroten) October 3, 2022 以下、本題です。 社長が担当する重点プロジェクト。途中経過の内容がしょぼすぎたこれが考えたきっかけ。がっかりする内容だった。 ・事業が目指す将来像との接続が説明さ
私自身、物事を分かりやすく伝えるスキルを身に着けるため、手あたり次第に、いくつかノウハウ本を読んだり、YouTube動画を観たりしてきました。本記事では、本や動画から得られたノウハウや、私が普段の仕事で発見した個人的に使っているテクニックをまとめてみました。 0 本記事の最重要ポイント 本記事がストックの墓場に行ってもいいように、本記事の最重要ポイントだけ先に伝えておきます。 質問に答える時は、聞かれたことにシンプルに答える。 事実と解釈を分けて話す。 1 本記事で伝えたいメッセージ 1-1 コミュニケーション能力の苦手意識はノウハウで解決する ITエンジニアの裾野が広がるにつれて、SNSでも「コミュニケーション能力の低いITエンジニア」の話題をちらほら見かけるようになりました。いわく「これからはITエンジニアにもコミュニケーション能力が求められる」「プログラミングができるだけでは生き残れ
はじめに ソフトウェアプロジェクトには不思議な性質があります。現状のスケジュールに課題を感じて、短くするために人員を投下しても、なかなか思い通りに短くならない。それどころか悪化してしまうことがあります。場合によってはプロジェクト自体が破綻して失敗してしまうことすらあります。 今回は、このようなソフトウェアプロジェクトに潜む直感に反する性質を数理的なモデルを介して理解していく試みです。ある種の思考実験としてお楽しみください。 宣伝 Qiitaさんとコラボ企画でアドベントカレンダーをつくりました。 DXをめちゃくちゃ改善した話を募集しています。 https://qiita.com/advent-calendar/2021/dx-improvement 10人の妊婦がいても1ヶ月で一人の子供は生まれない これは誰かの技術力やプロジェクトマネジメント力に欠陥があるのではなく、「人月の神話」で有名な
「ロジカル・シンキング」という言葉からは、何か大変難しいものを想像しますが、まずは、そのコンセプトを伺えますか? 「ロジカル」というのは、理屈っぽく小難しいことと思われがちですが、全く反対です(笑)。「ロジカル・シンキング」というのは、文字通り、「論理的思考」ということですが、私は、これをコミュニケーションの手法に適用しています。自分が相手に伝えたいことを、分かり易く伝えるためのアプローチと考えていただければと思います。 今までも、提案など、伝える中身をどう作り上げていくのか、そこに「論理的思考」を適用するということは行われてきましたが、最近、コミュニケーションの場面でこのロジカル・シンキングに興味を持つ方が増えてきました。これは特にビジネスにおけるコミュニケーションの重要性が意識されつつあるからでしょう。 というのも、物事を進めていこうとする時、どういうことをやりたいのかといった方向性を
Scrum Fest Mikawa 2021の登壇資料です。 以下は資料内で引用している参考リンクです DPA https://qiita.com/viva_tweet_x/items/97e819c626979b78947a KPT http://objectclub.jp/download/files/pf/KPT_TIPS.pdf TimeLine https://developers.freee.co.jp/entry/timeline-is-a-good-retrospective-method 象、死んだ魚、嘔吐 https://no-kill-switch.ghost.io/elephants-dead-fish-vomit/ Start Stop Continue https://www.retrium.com/retrospective-techniques/start-
Takumi Sueda @puhitaku -san という概念は非日本語話者からするとちょっとおもしろいらしく、こっちから -san 付きでメールを送ると「マジの日本人に san 付けで呼ばれた」とちょっと喜ばれたりする。敬称なので失礼なく雰囲気を和らがせることができる。ソースはワシ。 2021-09-30 22:25:29 Takumi Sueda @puhitaku 引用元と同様に「-san が無いと失礼?」というのも聞かれたことがあって、「日本人は英語圏の名前文化も知ってるから敬称なしで全く問題ないけど、あるとちょっと楽しいしつければ良いんじゃない?」と返答した 2021-09-30 22:34:22
スタートアップは最初期から広報を開始するべきでしょうか? どのステージで何を優先し、具体的な施策や体制はどうすべきでしょうか? こうした問いに一般論で回答するのは難しいものですが、各ステージにおける考え方の指針や、取りうる施策を先に知っておくことは役に立つかもしれません。 Coral Capitalでは投資先企業に対して広報支援をしていますが、今のところ比較的初期のみです。そこで最初期から上場後まで、さまざまなステージの広報活動に携わってきた公益社団法人日本パブリックリレーションズ協会 広報委員の日比谷尚武さんに「スタートアップ広報」の考え方についてお話をうかがいました。日比谷さんは、BtoB/IT広報勉強会の主催者や、2009年に参画したSansan株式会社でのマーケティング・広報機能の立ち上げなどで知られています。 本記事の続編はこちら: メールタイトルに「取材希望」はあり?― 続・ス
1on1 で伝えたので外にも書いておく。 プロダクトやチーム、メンバーのフェーズ まず現状分析。 自プロダクトは PPM で言う花形、金のなる木、問題児、負け犬のいずれに当たるのか 勢い MAX でめっちゃ盛り上げるのか、地味に役割を達成するのか。自チーム全集中なのか他チームのフォローに回るのかみたいな方針が変わる 自チームは エラスティックリーダーシップ で言うサバイバルモード、学習モード、自己組織化モードのいずれに当たるのか チームを改善しなければいけないのか、プロダクトだけを見ていて良いのか。チームで改善できるのか、リーダーや外部の強い意志が必要なのか 各メンバーは、期待される役割において SL理論 で言うとどのフェーズなのか 指示的行動が必要だとマイクロマネジメントすることになり、マネージャ/メンター的な人/行動を増やす必要がある 役割を網羅しているか こういう軸で考えていることが
周りを見ていると何の苦もなく英語社会に適応しているわけですが、日々苦しんでいる人の奮闘記があっても良いのではないかと思って書きました。残念なエピソードを晒すことで実は自分もこうやって乗り切ってましたという人が現れお互いに助け合えることを期待しています。 概要 前提 バッドノウハウ 質問編 聞き取れなかった時にSorry?と聞き直さない 聞こえたところまで繰り返す 可能性のある質問全てに答える Do you mean ~ ? で可能性を潰していく うかつにYES/NOで答えない 他人に振ってみる 良い質問ですねぇを使う 何か言いそうな雰囲気を出して時間を稼ぐ 発言編 How are you?を速攻でキメる Can you hear me? Can you see my screen? に率先して答える How are you?にHow are you?で返す 発表編 話し続ける 質問が出ない
江口幹太|HACHIDORI(元カンタ🇺🇸) @theonlyonekanta アメリカで絶対やらない方がいいNG行動... ①店員を大声で呼ぶ ②チップを払わない ③公共の場で飲酒 ③バスで後ろに座る ④荷物を置いて席確保 ⑤短時間でも幼児だけを車に残す ⑥許可を取らずに土足で家に入る ⑦頼み事の際に「Please」を付け忘れる ⑧「ファイトー!」と応援すると喧嘩になる 2021-07-03 11:33:40 江口幹太|HACHIDORI(元カンタ🇺🇸) @theonlyonekanta ①店員を大声で呼ぶ これめちゃくちゃマナー悪いです。日本の居酒屋の感覚で「すいませーん!」って呼ぶのは無礼に当たります。じゃあどうやって呼ぶかというと、そもそもウェイターが定期的にテーブルを確認しにきます。それ以外だと目力で呼び込む。ウェイターと目を合わせに行って訴える。 2021-07-03
ブレイクタイム 松永成立が指導者として意識していること。ドーハの悲劇を経験したGKのターニングポイント # 森雅史 2021年4月2日 日本サッカーがアマチュアからプロに移行するとき、日本代表のゴールを守り続けていたのは松永成立だった。激動の時代を過ごし、ドーハの悲劇にも直面した経験豊かなGKは、今、後進の指導に当たっている。 サッカーの中で特別なポジションであるGKをどうやって育てるのか。自分の考えを変えたターニングポイントは何だったのか。じっくりと話を聞いた。 人によって評価方法は違う (写真提供:横浜F・マリノス) 今、僕は横浜F・マリノスのGKコーチとしてGKを指導しています。このGKを育てるというのは、コーチがどういう観点からGKに対して接しているかというのが一番大事なんですよ。 たとえばGKコーチが「こういうプレーをさせたい」という意図を持っていたとしても、チームには当然監督が
「恩師」の意味を「人生全体に渡って、大きく影響を及ぼす程の薫陶を受けた人」と定義した場合、私には恩師と言って良さそうな人が二人います。 一人は、小学校の3年から4年の時に担任をもってもらったH先生。 もう一人は大学の専門課程、国語学研究室でお世話になったS先生。 H先生については、人生の選択に関わる重要な示唆を色々と頂いたなーと思っていて、例えば昔この記事で書いたんですが、 忍者ハットリくんが、私の人生を大きく変えた、という話。 「ファミコンの忍者ハットリくんに巻物が出てきてかっこいいから、本物の巻物にも触ってみたい」 と素っ頓狂なことを言い出した私に、 「巻物は大学行かないと触れないよ」と答えて、さり気なく「大学=巻物」という刷り込みを行ったのがH先生です。 多分私、この教えがなかったら大学行ってませんでした。 上記の記事でも書いた通り、私は大学での専攻として、「巻物に触りたいから」とい
2019年3月10日、「中田敦彦氏講演会『僕たちはどう伝えるか』 in Kichijo-ji〜人生を成功させるプレゼンの力〜」が開催されました。芸人になるために親を説得したことを原点として、「人生をプレゼンの力で切り開いてきた」と語るオリエンタルラジオ中田敦彦氏。当講演では、自分の気持ちを伝え、相手に協力や賛同してもらうプレゼンの極意を明かします。今回は、ビジネスシーンだけでなく、人生においてプレゼン力が必要な理由を語りました。 人生はプレゼンによって変えられる 中田敦彦氏(以下、中田):みなさん、よろしくお願いします。中田敦彦です。 (会場拍手) ありがとうございます。素敵な会場でやらせていただけてうれしいなぁ。なにせ僕は、中学3年生から高校3年生までの学生時代という、一番多感な時期に吉祥寺に住んでいたんですよ。だから、僕という人間をほぼ作り上げた街といってもおかしくない。吉祥寺のせいで
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く