LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://speakerdeck.com/naohiro_nakata/technicalwriting2023
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting
5月に『アイデア大全』を読んで以来、同書に書かれている「発想法」をいくつか試している。『アイデア大全』については下記記事で感想をまとめているので、詳しくはそちらをどうぞ。 アイデアを生み出すための手法が、42個も掲載されている本書。当然、すぐに全部を実践できるはずもないので、暇なときにちょちょいと読み直しつつ試している格好。 そんな発想法のうち、継続的に取り組んでいる手法がひとつある。 『アイデア大全』を最初から最後まで読んだうえで、特に「これはぜひとも実践したい！」と感じられた手法。6月上旬から取り組むようになり、この2ヶ月以上、なんだかんだで続けられている。それどころか楽しんですらいるし、メリットと言えそうな効果も現れてきている。 それが、「ノンストップ・ライティング」だ。 スポンサーリンク テーマなし＆時間制限ありのフリースタイルが楽しい！ 「ノンストップ・ライティング」 あるいは「
ピクサーに学ぶ！人を魅了するストーリーライティングの２２のルール
ユーザーに届ける価値を徹底的に追求する マーケティングを提供します © Copyright 2022 バズ部. All rights reserved. 文章で人を魅了する最も効果的なテクニックの一つがストーリーライティングだ。 いや、文章に限らず、会話でもスピーチでも、人から共感してもらうためには、ストーリーの力を無視することはできない。 ストーリーライティングは、私自身、今最も身につけたいと思っているライティングスキルの一つで、情報収集をしていたところ、『トイストーリー』などで有名なピクサーのストーリーライティングの２２のルールを見つけたのでシェアさせて頂く。 The Pixar Touch ” Pixar Story Rules “ １．成功ではなく挑戦にフォーカスする 主人公の成功という部分ではなく、諦めずに挑戦し続けるという部分を賞賛すること ２．自分ではなく読者が求めているもの
文書品質の向上と文書作成時間の短縮：｢考えが文にまとまらない」を解決するためのテクニカルライティング
<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">考えが文にまとまらない<
ユーザーに届ける価値を徹底的に追求する マーケティングを提供します © Copyright 2022 バズ部. All rights reserved. WEBマーケティングにおいて、ライティングの技術は必要不可欠だ。 決して大げさではなく、サイトやブログにどれだけ集客出来るかも、ランディングページからどれぐらいの売上をあげられるかも、メールマガジンを使って見込み客をリピート客まで育てられるかどうかまで全てライティングにかかっている。 そこで、本日は、特にブログやサイトに効果的な「読まれる文章」を書くためのライティングの技術を詳しくご紹介する。 この通りに試して頂ければ、下図のように、多くの読者に読んでもらえる記事を書くことができるようになる。 ぜひ、じっくりご覧頂いて、実践してみて欲しい。 また、私たちバズ部は12年で400社以上のメディア支援を行い、 立ち上げから10ヶ月で14.6億円
TEDを使ってリーディング・リスニング・ライティング・スピーキングの４つの能力を全て高める英語学習方法～お勧めの教材（TED動画）リスト付き～
【TEDの学習方法】目次 (1)100回以上繰り返し聞ける動画を探しましょう ⇒ (2)英文原稿を読み込む（精読する）。日本語に翻訳された原稿がある場合は先にそちらの原稿を読み込む。 ⇒ (3)TEDの音声ファイルを聴きこみ、そして音読しましょう。 ⇒ (4)移動時間中にTEDの音声ファイルを聴きこみましょう。目標として100回以上の聴きこみを目指しましょう。 ⇒ (5)マンツーマン授業のオンライン英会話で自分の理解度を確認してもらう。～本文朗読による発音チェック⇒要約による英作文能力向上⇒フリートーク・ディスカッション～ 【連絡】この記事にまとめた学習法を実践する語学学校、サウスピークを創りました http://souspeak.com/ 続きを読む
Web制作者を悩ませる問題に、「Webを熟知したコピーライターがいない問題」があります。特にメディア型のWebサイトの場合、文章の質がコンテンツパワー、ひいてはWebサイトの集客力・訴求力そのものになってきます。しかし現状、プロジェクトメンバーにコピーライターが参加しないのは当たり前になっています。 また、もしコピーライターをプロジェクトに参加させたいと思っても、Web特有のユーザ行動や設計思想、SEOなどに精通し、Webに相応しい文章を作ってくれるコピーライターは、この市場にごくわずかしか存在しないのではないでしょうか。 このWebのコピー問題は、考える以上に深刻です。なぜなら、文章の良し悪しで、コンバージョン率もユーザの満足度もブランドイメージも、簡単に変わってしまうためです。そして、その問題に対する私たちの結論は「全員でコピーをチェックして校正しよう」ということです。 私自身は今まで
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む
インフラエンジニア向けの書籍を取り上げ、著者と出会い、楽しく本を知り、仲間を作る場所である「インフラエンジニアBooks」。ここで、『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』の翻訳を担当した岩瀬氏が登壇。まずは、本書籍の概要について話します。 本セッションの対象者と、セッションのゴール 岩瀬義昌氏：ご紹介いただきました、岩瀬と申します。よろしくお願いします。『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』は、もともと『Docs for Developers: An Engineer’s Field Guide to Technical Writing』という洋書だったんですが、その翻訳をして、今回この機会をいただいています。 余談ですが、APC（株式会社エーピーコミュニケーションズ）さんが「カプセルト
「ライティングスキルを向上させたい」と思っているはいるものの、何をすればいいか分からないという人、多いのではないでしょうか？「文章力」は一朝一夕で身につくものではありませんが、プロの技術や考えから、すぐに使えるノウハウやエッセンスは学び取ることができます。 そこで今回は、「ライティングスキルを磨きたい！」と思っているWeb編集者に向けて、確実に読んでおくべきライティングのノウハウが学べる記事と本を30個まとめました。 これだけは読んでおきたいライティング系の記事 1.ライティングでは書き始める前の考えの整理や視点の確認が大切editor’snaut(※2020年8月現在ブログ閉鎖中) THE BRIDGEやマチノコトといった複数の媒体でエディター/ライターとして活動するモリジュンヤ氏が、文章を書き始める前に頭の中を整理することの重要性を説いた記事。思考の整理に役立つオススメの書籍も紹介され
ayan's style > サイトコンテンツ作成 > WEBライターが教える「読みやすい文章」を書くためのライティングのコツ 私はブロガー13年目、最近はWEBライター／旅ライターとしての仕事もしています。 先日、「視点の違いで作り出せるものは変わる！ 新たな視点を獲得する方法」という記事を書きました。読んでいただけるとわかるのですが、書籍のレビューを通常とはちょっと違う切り口で書いた文章となります。 通常は書籍のレビューというと、「○○という本を読みました。その本は…」と、まず本を最初に持ってくると思うのですが、今回はすでにネット上に同じ書籍のレビューがたくさん公開されている状態だったため、最初に本のことを書かず、文章の後半で自然な形に本の内容に触れられる構成を意識しました。 この記事を公開した後、その文章の書き方について、まわりのブロガーさんから以下のようなお言葉をいただきました。
ユーザーに届ける価値を徹底的に追求する マーケティングを提供します © Copyright 2022 バズ部. All rights reserved. WEBライティングを正しく学び実践することで検索エンジンからの流入が加速する。 webを閲覧するユーザーにとって最適な形でライティングを施すとユーザーからの支持が得られ、それが結果として検索エンジンの評価に繋がるということだ。 スマートフォンの普及に伴って「読みやすいライティング」と「読みにくいライティング」の差が浮き彫りになっている。 あなたも、テキストがぎっしり詰まったwebページに遭遇した経験はないだろうか？たくさんスクロールしても、なかなか答えに辿り着かないストレスフルな経験を味わったことはないだろうか？ このようなユーザー体験を損ねるライティングは最悪だ。ユーザーに嫌われるし、検索エンジンからも嫌われる。たくさんのユーザーに読ま
エンジニア向けライティング講座。見落としやすい注意ポイントを徹底解説！ - エンジニアHub｜若手Webエンジニアのキャリアを考える！
エンジニア向けライティング講座。見落としやすい注意ポイントを徹底解説！ 個人が趣味で運営するサイトと、企業が事業として提供するサービスでは、責任の大きさが違います。守るべき法律やライセンスがあり、モラルが厳しく問われるだけでなく、掲載する情報の正確さ、分かりやすさに気を配ることも大切です。開発を業務とするときに、エンジニアリング以外でどんなことに気をつけるべきでしょうか。 こんにちは、Webエンジニアとして企業に勤めている池田（@ikenyal）です。 この記事では、サービス開発を業務とするエンジニアが、作成したプロダクトや提供する企業の価値を低下させないために、エンジニアリング以外の部分で心がけたいポイントについて紹介します。 個人が趣味で公開しているWebサイトと、企業などが事業として提供するWebサイトでは何が違うのでしょうか？ 一番の違いは、責任の大きさだと思います。個人のサイトに
「Otter」「DeepL翻訳」「Grammarly」など、便利なAIツールを駆使して英文ライティングに挑戦 - ENGLISH JOURNAL ONLINE
「Otter」「DeepL翻訳」「Grammarly」など、便利なAIツールを駆使して英文ライティングに挑戦 近年は人工知能（AI）を活用した自動翻訳や自動添削ツールが増えています。Otter、DeepL翻訳、Grammarlyなど、自分の英語力の足りない部分を補ってくれる便利なAIツールを駆使して、英文ライティングに挑戦してみましょう。 英文ライティングに自信がない人に助け舟リーディングやスピーキングの練習に比べると、後回しになってしまいがちなライティングですが、単なる語彙力や文法力だけでなく、表現の豊富さや、文章の構造など、総合的な語学力が求められる、非常に高度な分野だと言えます。英語の上達を目指している人ならば、常日頃からライティング力を高める勉強をしておきたいものです。 とはいえ、誰もがそんなに律儀で計画的とは限らないのが現実です。実際には、「来週までに英語で資料を準備しておかねば
「自分の書く文章は価値がない」を抜け出すライティング・マラソンという方法←自己検閲を振り切って書きなぐるために
ものを書く人は自由人である（少なくともそうありたいと思っている）から、 これは書くことがとことん苦手な人のために書いた文章です→小学生から大人まで使える素敵な方法 読書猿Classic: between / beyond readers のような型（かた）の話をすると結構反発を食らう。 すでに書いている人たち向けに書かれたものでは、たとえば 書きなぐれ、そのあとレヴィ＝ストロースのように推敲しよう／書き物をしていて煮詰まっている人へ 読書猿Classic: between / beyond readers のような記事がある。 しかしレヴィ・ストロースのようにはできないという声も寄せられる。 何より、立ち止まらず振り返らず、ただ書きなぐっていくのが難しい。 心の隅から湧き上がる自己検閲の声はしばしば、書きなぐる速度よりも速く、我々をつかまえてしまう。 「本当にそうなのか？」 「そう言い切れ
技術をわかりやすく伝えるためのテクニックとしての「テクニカルライティング」を学べます。Developers Summit 2023の登壇資料。開発者・エンジニアの方向け。 https://twitter.com/naoh_nak
どうもタクロコマ（@takurokoma）です。 この記事では、プロのカメラマンでも素人のブロガーでもなく、Webライターを生業にしている人に向けて、取材で活きる写真の撮影、画像編集、入稿方法を余すことなく紹介します。 そもそもこの記事を書くきっかけは、最近の「灯台もと暮らし」ではWebライター向けの記事がよく読まれているからです。Webライターにとって「わかりやすい文章を書ける」ということは、必要不可欠なスキルです。それに加えて、写真を扱うスキルを最低限身に付けておかないといけません。最近のライター募集には、写真を扱うスキルが必須項目として上げられていますよね。 しかし現状は、「カメラを持っていない」「買ってみたけど、なんとなくそれっぽく撮っているだけ」という人が多いのではないでしょうか。取材で撮影した後、編集してWebに適した入稿ができないなら、仕事はもらえなくなると言っても過言ではな
もう間違わない！英語ライティングに使える6つの無料英語自動校正ツールを徹底比較！！ | Enjoy Learning English!!
こんにちは。英語学習コーチのタニケイです！ みなさん、英語のライティングを習慣にしていますか？英語でブログを書いたり、FacebookやTwitterに英語でポストしたりしている方もいるかと思います。ライティングの練習をしておくと、英文を組み立てる練習になりますし、時間をかけても書けないものはやっぱり話せないので、書く練習をしておくとスピーキングにも役立ちます。 でも英語で文章を書いたとき、それが正しい英語なのかどうか不安になること、ありますよね？そんなときに役立つのが英語校正サイトです！しかし、ネット上にはいくつもの校正サイトが存在します。 そこで今回は、6つの校正サイトをピックアップ。そして、それぞれの機能や使いやすさを調べるために、ある3つの英文(英語が正しいもの・英語学習者が書いたもの・間違いだらけのもの)を、6つすべてのサイトで校正をかけて比較してみました！ このブログでは、それ
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
テクニカルライティングの基本
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
テクニカルライティングの基本 2023年版
「書く」を鍛える発想法「ノンストップ・ライティング」の魅力（アイデア大全より） - ぐるりみち。
たった1記事で8万人に読まれる文章を書けるようになるライティング術
誰でも良い文章が書ける！Webライティング11のルール（スライド） | ベイジの社長ブログ
LINE社内テクニカルライティング講座第2弾！1文では説明が終わらない文章を書くコツ
「ドキュメントの書き方」を体系的に学んだことがないエンジニアへ 書籍『エンジニアのためのドキュメントライティング』の概要
ライティングのプロに学ぶ！文章力UPに役立つ良記事&良書30選
WEBライターが教える「読みやすい文章」を書くためのライティングのコツ | ayan's style
WEBライティングでSEO効果を倍増させるために絶対やるべき17のこと
技術をわかりやすく伝えるためテクニカルライティング
【寄稿】写真が撮れてこそWebライター！本気でライティングを仕事にしたい人のための写真術