この連載では「超時短テクニカルライティング」と称して、生成AIを活用しながら効率的に質の高いドキュメントを作成するときのアイディアをいくつか紹介します。普段、IT製品のマニュアルや仕様書などのドキュメントを作成している人はもちろん、それ以外のドキュメントを作成するときにも役立つ内容です。連載第1回である今回は、生成AIを活用したドキュメント作成の流れを掴んで、ドキュメント作成へのハードルを下げる方法を解説します。 本記事の著者 株式会社ソラコム　テクニカルライター　矢崎 誠 SORACOMのドキュメントをメンテナンスしたり、生成AIを利用するSORACOM Support Botを開発したりしているテクニカルライター。アベイズム株式会社→有限会社ビートラスト（フリーランス）→LINE株式会社→株式会社ソラコムと何度か転職はしていますが、社会人になって約25年間、常にテクニカルライターです。

今週、皆さんはどんなふうに「お願いごと」をしましたか？ システム開発や、新規事業創出にまつわるプロジェクトにおいては、プロジェクトリーダーやプロジェクトマネージャーが、開発部門に対して「〜を作ってほしい」とお願いする局面がしばしば訪れます。 そういった場面において、コミュニケーションの齟齬などが引き金になり、結果として、誰しもが「こんなはずじゃなかった」と感じるものが出来上がってしまうことは珍しくありません。 世のほとんどの仕事は一人で完結しない、誰かに何かを作ってもらわなければ成り立たないものです。 だからこそ、仕事の質を上げ、キャリアアップを目指したいビジネスパーソンにとって、「お願いごと（依頼）の技術」は必要不可欠と言えるでしょう。 そこで今回は、システム開発やビジネス・プロセス・アウトソーシング（BPO、業務プロセスの一部を外部委託すること）を牽引するコンサルタントとして、数々の大

各システムの詳細は個別の説明ページをご覧ください。 ご質問やコメントがあれば Facebookグループ にご参加ください。 Japanese / English 日本語文章難易度判定システム jReadability 日本語文章のテキストを入力すると、その難易度を6段階で判定します。詳細な語彙情報を出力したり、テキストに含まれる語句の意味や用法を表示したりする機能もあります。

要約、箇条書き、コールアウト、太字、役立つ視覚情報などのテクニックを用いることで、1,000語を超えるコンテンツの理解度やエンゲージメントは向上する。 5 Formatting Techniques for Long-Form Content by Huei-Hsin Wang and Megan Chan on November 17, 2023 日本語版2024年3月19日公開 ウェブでは、多くの場合、ユーザーは特定の情報を探している。そのため、ページにある単語を1つ1つすべて読むわけではなく、ユーザーは流し読みをする。つまり、要約や箇条書き、視覚情報、太字のテキストに注目して、探しているものをすばやく見つけ出そうとしている。そこで、テキストの壁を崩す書式テクニックを用いれば、流し読みのしやすさが向上するだけでなく、重要な情報に注意を引きつけることで、読者がコンテンツを効率的かつ効果的

著書の中でも「短いは正義」ということを繰り返し伝えていて、とにかくテキストは短く書くことが大切だと思っています。 なのですが、本というメディアの特性上、数千字の数ページで出版するわけにもいかず、ある程度のボリュームになっています（それでもかなりコンパクトにはまとめているのですが）。一冊読み切るにはそれなりの時間を要するので、まとまった時間をなかなか取れないという方もいると思います。 そこで今回は、特にプロダクトのテキストを書くとき私が気をつけていることを、シンプルにまとめたいと思います。業務でプロダクトのUIテキストを書くことがあるけど、チームにUXライターがいない、という方は、このnoteをチェックリスト的に使っていただけると幸いです。もし役に立ったら、ぜひ「秒で伝わる文章術」を買ってみてください…！ それではさっそく始めていきます。 ①一文字でも短くする❌画面を上にスワイプしてロックを

テキスト要素の役割は大きく、特にアプリやゲームでは、適切な言葉遣いがユーザー体験に大きく影響します。WWDC23の開催期間中、Apple UXライティングチームは技術的な概念から始まり、インスピレーションをもたらすコンテンツ、アプリに「個性」を持たせる必要性についてなど、幅広いトピックに関してQ&Aセッションを行いました。今回、このQ&Aの抜粋と、ユーザーインターフェイスのライティングをさらに深める上で役立つリソースをいくつか紹介します。 インターフェイスのライティング Watch now 自分のアプリでは大量のテキストを使っています。文章を読みやすくするベストプラクティスについて教えてください。「この文章を使って何を達成したいのか」ということをまず自問してください。その答えに沿って、文章作成に取り組みます。まずは各段落を、一つひとつの文章に分けます。そしてはじめに戻り、各文章を可能な限り

相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況（読む場面、事前知識など）を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1：法律や業務に関わる記事目的業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before日本の年金制度は、全国民

はじめに 私は事業会社（楽天→スタートアップ）でUXライティングを専門としてプロダクトの開発に携わっています。しかし、事業会社で私のような専任のUXライターやコピーライターを雇用している企業は決して多くありません。 多くの場合、UXデザイナーやUIデザイナー、エンジニア、プロダクトマネージャー、マーケターなど、UXライティングに比較的近い立場の方が、自分自身でUIテキストを書かなければならない、というのが実情だと思います。 そうした状況で試行錯誤されている方に向けて、自分に何かできることがあるのではないかと思い、このnoteを書くことに決めましたら。私がUXライティングの知見をしっかりと整理して伝えれば、役に立つのかもしれないと。 このnoteでは、私なりの実践的なUXライティングの方法論を言語化します。あくまで私が実践しているものなので、考え方もやり方も違うし、こんなのUXライティングじ

こんにちは。Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。LINE社内で大評判のテクニカルライティング講座をブログにまとめてみたシリーズも第3弾になりました。（第1弾、第2弾もぜひ読んでください！） 今回の記事では、以下のようにトピックが多く集まったときに「自分が書いたトピックを（その情報が不要な人に）読ませないためのコツ」を説明します。具体的には、順番に気を配ったり、情報の分類を気をつけたり、タイトルを工夫したり、という話をします。 全部読んでもらおうとしていませんか？ おそらくほとんどの人は、ほかの人の文章を読むときに、必要そうな文だけピックアップして読んだり、タイトルだけで内容を判断したつもりになったりすると思います。検索エンジンで検索したときに、表示された内容だけで、文章の内容を推測して読むか読まないか決めますよね。そう

こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む

LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま

こんにちは、Developer Contentチームのmochikoです。LINE株式会社でテクニカルライターとして働いています。今日は「テクニカルライター」というお仕事と、LINEにあるテクニカルライティングの専門チームについてお話しします。 テクニカルライターという職種があります テクニカルライターって何をしてるの？何を書くの？ ドキュメントはどうやって書いてるの？ どんなメンバーで仕事をしてるの？ ドキュメントを書く以外にこんなこともしているよ でもドキュメントを書くだけだと技術力が下がらない？ どんな人がテクニカルライターに向いてるの？ テクニカルライターという職種があります 私はもともとウェブ制作会社のインフラエンジニアでした。とある技術書を書いたことをきっかけに「テクニカルライターとして一緒に働きませんか？」と声をかけてもらい、LINEへ転職するに至ったのですが、実はお誘いをい