こんにちは！株式会社Rabeeのデザイナーのakaneです🐏 今日は、私がnoteを執筆するときに意識しているポイントを書いてみます。誰でも・いつでも・すぐに再現できるよう紹介していくので、ぜひご活用ください🕺 ちなみに、普段はこんなnoteを投稿しています👇 今回のnoteでは、とくに「noteの書き方」にフォーカスしていますが、テキストコミュニケーションを考察した以下のsakinoさんのnoteにも影響を受けています。 はじめに突然ですが、以下のnoteはどちらが読みやすいですか？ このように尋ねられると、多くの人が「B」を選んでくれるのではないでしょうか（という前提で話を進めます）。 では、どうしてBが「読みやすい」と感じるのか。 わたしは、文章が「デザイン」されているからだと思っています。 読みやすい文章は「デザイン」されているそもそも「デザイン」って何を指してるの？というと

リモートワークで仕事をしていると、Slack や Teams といった何かしらのチャットツールでコミュニケーションを取ることが多い。そうやって仕事を続けていく中で「こう伝えたらよりスムーズに話が進んだかな...」という後悔は多々あり、日々試行錯誤を続けている。 そうやって試行錯誤を続けていく中である程度テキストコミュニケーションを取る上でのフォーマットが定まってきた気がするので、箇条書きでまとめてみようと思う。（随時更新予定） prefix （接頭辞）をつける文章の先頭にその文章の目的がわかるような prefix をつけて、何のためにポストしたかを一目で分かりやすくする。例えば以下のような prefix をつけることがある。 【質問】→ 相手の返信が欲しい時 【共有】→ 返信は不要だが、内容は把握しておいてほしい時 【メモ】→ 返信不要で、後から検索できるよう残しておきたい時 箇条書きする

ベクトルの準備 次にタイトル文章をベクトル化していきます。 OpenAIのアカウントを作成し、こちらからAPIキーを取得し、それを環境変数OPENAI_API_KEYに設定した後、次のコードを実行するだけで、入力文章のベクトルを取得できます。 import os import openai openai.api_key = os.environ["OPENAI_API_KEY"] client = openai.OpenAI() def get_embedding(text, model="text-embedding-ada-002"): text = text.replace("\n", " ") return client.embeddings.create(input=[text], model=model).data[0].embedding get_embedding("入力し

はじめに こんにちは！ 今回は、「求められている情報を的確に伝える方法」をまとめたので共有したいと思います！ 仕事上のテキストコミュニケーションで、以下のような問題に直面しました。 1. 情報の詰め込みすぎで、文章量が膨大になってしまった 2. 最終的に伝えたいことが迷子になってしまった これらの問題を解決するために実践している方法を共有させて頂きます！ 他に皆様の意識していることがあれば、ぜひ教えてください！！ 参考本 結論 1.読む相手を明確にする 2.主題は1つに限定する 3.主題に収束する全体像を練る 4.結論ファーストで書く 5.感想は含めず、事実と意見だけを書く 1.読み手を明確にする 読み手が誰であるのかを事前に明確にすることで、文章内容の精査を行うことができます！ 読み手はだれなのか その読者は、どれくらいの予備知識があるのか その文書に何を期待し、何を要求しているのか こ

毎回1つのテーマに絞り、テーマに対してのLTを行うTechDLT。「ChatGPT」をテーマにした「ChatGPTについてLT！ TechDLT Vol.10」に登壇したのは、ほりゆう氏。OpenAI APIを用いた、技術ブログ記事作成アプリの開発について発表しました。 登壇者の自己紹介 ほりゆう氏（以下、ほりゆう）：みなさま、本日はお時間をいただき、ありがとうございます。主催者のみなさま、参加者のみなさま、どうぞよろしくお願いします。「OpenAI APIを用いた技術ブログ記事作成アプリを開発した話」を紹介いたします。 まずは自己紹介からさせてください。私はエンジニアをしている堀越優希、ほりゆうと申します。もともと文系で、高等学校の国語科の教員をしていました。現在27歳です。エンジニアになったのは2020年の7月なので、今3年目くらいです。 ふだんはRailsやReactで開発をしていま

先日、当サイトで『正確に文章が読めない人の話。』という記事が公開され、たくさんの人に読まれていた。 記事中では、読めないのは読み飛ばしや勝手な解釈が要因であることが多く、文字で認識するのが苦手な人には音声（声）で伝達するほうがいい、と締められている。 たしかに、連絡事項をすべて書いたにもかかわらず、「あれ、そんなこと書いてありましたっけ？」と言われたり、「すみません、ちゃんと読んでませんでした」と謝られることはある。 いくら丁寧に書いても、相手が読んでくれないことにはどうしようもない。 困ったものだ。 でもね、知ってるんです。 文章が読めない人のなかには、結構な割合で、「文章をちゃんと読まなくてもいい」と思っている人がいることを。 漢字が読めなくても気にしないゲーム実況者たち わたしはゲームが好きで、よくゲーム実況（ゲームしている様子を配信しているもの）を見ている。 そこで驚くのが、漢字が

”ユーニス・パーチマンがカヴァデイル一家を殺したのは、読み書きができなかったためである” という一文から始まる「ロウフィールド館の惨劇」というミステリ小説がある。 「読み書きができない家政婦」がその劣等感をこじらせ、一家惨殺に及ぶまでを追いかける話で、映画化もされている。 3年ほど前に知人のすすめで読んだのだが、倒叙ものや、変わった話が好きな方は読んでみても良いと思う。 ＊ ただ、ストーリーの強烈さより私が覚えているのは、文盲までいかずとも「文章が正確に読めない人」は、今でもかなりいるな、と思ったことである。 例えば、リーダーが部下に、こんなメールを送ったとする。250文字だから、ツイート2つ分弱だ。 明日の朝10時までに、私をCCに入れて、Yさんにメールを送っておいてください。内容は次回の定例までの宿題事項と、現在までに積み残している課題の一覧の二つです。積み残しの課題については、期限を

この文章は文章作成アドバイスツール 「文賢（ブンケン）」でチェックし、作成しました。 文賢マガジン編集部の松尾です。 世の中には2種類の文章があります。 「表記揺れの少ない丁寧な文章」か「表記揺れの多い雑然とした文章」か。 表記揺れとは、同じ意味を表す言葉なのに、さまざまな表記が混在している状態を指します。 たとえば、表記揺れには「申し込み／申込み／申込」「Webサイト／WEBサイト／ＷＥＢサイト／ウェブサイト」といったパターンがあります。 表記揺れのある文章は、読み手に負荷をかけるだけでなく、文章が丁寧に書かれていない印象を与えてしまいます。 その結果、読み手の満足度が下がったり、ブランディングに影響が出てしまったりするのです。 今回は表記揺れとは何かを説明したあとで、表記揺れのよくあるパターンや、表記揺れを防ぐ方法について取り上げます。 また、ダウンロードしてすぐに使える「ひらがなで書

皆さんこんにちは。typoの達人です。2019/4/1からブログを書き始めて1ヵ月ほどになりますが、いまだにtypoが多くて悩まされております。 今回はそんな自分を変えるべく、lintとAIツールを駆使してtypo環境を改善していきます。 textlint textlintとは 環境構築 textlintを自分好みの設定にカスタマイズする 技術文書向けルールプリセット スペースの設定 表記揺れの検知設定 最終的にこのような設定ファイルになりました。 Proofreading API Proofreading APIとは API KEYの発行 デモを試す 組み合わせて使用する 問題点 最後に 参考サイト textlint textlintとは 文章作成などに使える自然言語のためのlintツールです。 textlint.github.io 環境構築 Node.jsはインストール済みの前提で進め

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

Mercari Advent Calendar 2017の3日目はmhidakaがお送りします。 Advent Calendarで空いてるところに収まったら12月3日は日曜日ということで、エンジニアの趣味的な話です。 筆者は技術的なブログや書籍を書くかたわら、技術書のためのイベントなどを開いてます。 技術を追求すること、プログラミング、まとめることが好きでモバイル分野で継続的に書籍を出版しています。 内容はおおむね同人誌作りへ適用している技術の話です。 書籍の作り方は出版社によっても違いますが、紹介する内容と同様の作り方をしている商業書籍もたくさんあります。 ここでは著者の目線から出版業界のテクノロジーをのぞいてみましょう。 作る楽しみと読者の視点 著者が本を書く動機は人それぞれですが技術を広めたい、たくさん売れたい、自分の知識をまとめたいなど目的を持って書き始めます。 また一方で書籍の目

秋山です。 機械学習が人気ですが、「Word2Vec」「Doc2Vec」という、文章などを分析するニューラルネットワークモデルを知っていますか？ すごーく簡単に言うと、「Word2Vec」は単語の類似度のベクトル、「Doc2Vec」は文章の類似度のベクトルを表現します。 結構前に話題になったので既に知っている人も多いかもしれませんが、今回はpaizaのスキルチェック問題に提出された一部のコードを対象に、「Word2Vec」と「Doc2Vec」でどんなことができるかやってみたいと思います。（※スキルチェック問題や回答の内容は判別できないように処理しています） ■Word2Vecについて ざっくり言うと、ある単語の周辺に別の単語が出現する確率……みたいなものを見てくれます。ニューラルネットワークを使って、類似度を求めています。Word2Vecは隠れ層1、出力層1の、2層のニューラルネットワーク

こんにちは。 漫画「めしにしましょう」が好きすぎて、 著者である小林銅蟲先生のブログ negineesan.hatenablog.com を漁り読む日々を過ごしています。 「小林銅蟲先生っぽい」文章が面白くて文体を真似るファンが続出しているのを観測しており、人気の高さが伺えます。 まだ読んでいない人はめちゃくちゃおもしろいので今すぐ読みましょう。 [まとめ買い] めしにしましょう（イブニングコミックス） 作者: 小林銅蟲メディア: Kindle版この商品を含むブログを見る さて、今日は朝7時に目覚めてしまったので、何を思ったかマルコフ連鎖で「小林銅蟲先生っぽい」文章を自動生成してみることにしました。 ※ブログ掲載にあたって小林銅蟲先生に許可を頂きました。 マルコフ連鎖とは wikipedia を見てもさっぱりでした。 概要だけ把握する場合、 マルコフ連鎖を説明してみる。 | 分析のおはなし

こんにちは！ 新オフィスに移転してから毎日2缶ドクターペッパーを買うのが習慣化してきた @fortkle です。 今回はSlackで簡単に文字校正ができるBotを作ってみたのでご紹介したいと思います。 手軽に校正したい メールやチャットだけでなく、こういったブログやissueに書く仕様など「文章を書く」シーンはたくさんあると思います。 そんなとき自分が伝えたいことを相手にちゃんと伝えることができれば良いのですが、良い文章を書くのはなかなか難しく、今も試行錯誤しています。 そこで、相手に伝えたいことがちゃんと伝わる良い文章を書くためにSlack上で簡単に試せる文字校正Botを作ってみました。 成果物 実際に見たほうが早いと思うので画像を交えてご紹介します。 例として以下の文章をチェックしてみたいと思います。 この文章はご存知の通り、ダミーテキストです ヽ(^o^)丿 そして、様々な、ｴﾗｰﾁ

技術文書を書く際の、心技体についての解説です。 心：記事を書くときの心構え 体：技術文書の構成要素とその目的 技：各要素の書き方Read less

はじめに こんにちは植木和樹＠上越妙高オフィスです。クラスメソッドではAWSを始め、弊社で取り扱っている製品・サービスに関するサポート業務を行っています。 サポートでは日々様々なお問い合わせを受け付けるわけですが、ご質問に対する回答内容は正しくても、言葉が足りないためにお客様が不満に感じてしまうことがあったりします。「正しいことを伝えたのに、どうして不満と感じたんだろう？なにが足りなかったんだろう？」と対応を振り返る際に、私はキーワード／パターン／フレームワークに当てはめてみて考えるようにしています。 今回はサポートメンバーがよりよいサービスが提供できるよう、自分のアンチョコから5つのキーワードをご紹介したいと思います。 1.安心してもらう 自分で書いた回答内容を見返してみましょう。文章の内容がお客様に安心を与えているでしょうか？ 最後に「安心です」がつくように意識しましょう。また「文章の

どのような職種でも、多かれ少なかれ文章を作成する機会はあるでしょう。 文中に間違いがないかどうかを確認する校正・校閲の作業は非常に重要ですが時間と精神力を要します。 今回は効率よく文章校正するために登録なしで使えるツールをまとめました。文章校正の参考にしてください。 Yahoo APIを利用した校正ツール オンライン上で利用できる文章校正ツールの多くがYahooのWeb APIと呼ばれるサービスを利用したものです。 そのため、以下で紹介する3つのツールの校正結果は同じになります。 ただ、使い勝手が多少異なるのでそれぞれご紹介します。 文章校正ツール http://so-zou.jp/web-app/text/proofreading/ こちらは文章を入力する方法が2種類あり、1つは直接テキストを入力する方法でもう1つはURLから読み込む方法です。 ただし、URLから読み込んだ際はサイト内の

社内向けの教育資料を、ど素人でもわかるようにと思いながら作っていて、じゃあ「わかりやすい」って何だろうって考えてた。今まで読んできたいろんなわかりやすかった本とそうでない本を思い浮かべながら、一般的にここを注意すればわかりやすさを確保できるだろうっていうポイントを一旦まとめておこうと思った。そうしてまとめてみると、本に限らず人に何かを伝えること一般に適用される話だなと思った。 読む側の負担を減らす わからない＝理解をはばむ障害物がある。この障害物を取り除く／回避する作業が「わかる」ために必要になる。その作業を、作者ではなく読者が負担するとき「わかりにくい」本になる。 日本社会だと情報の受け手の側がこの「わかる」ための作業を負うことでコミュニケーションを成立させる傾向にある。空気を読むというようなことだ。そのため発信者側が事前に手を尽くしてわかりやすく発信するというのが苦手で、相手が汲み取っ

ブログや、レポートなど、文章を書きたいけれど、何を書けばいいのかアイデアが浮かんでこない方への処方箋。 頭の中にモヤモヤと沸いてきた思考を文字起こしする時に、ピッタリの方法があったので紹介したいと思います。参考になれば嬉しいです。 書いたことないけど、小説とかでも使えそうな気がします。（誰か試してください） 必要なもの 携帯端末の音声認識の精度はかなり高い Google音声入力で文字起こしをするメリット 考えたことを文字に起こせる アイデアをどこでも記録出来る 編集力が上がる 準備する必要がなく手軽に試せる 音声入力で文章を書いてみた アイデアの生産方法として便利 音声入力したテキストの起こし方 文章の目的を考える 誰に伝えたい文章なのか（Whom） 何を伝えたい文章なのか（What） どのように伝えるのか（How） なぜ書くのか（Why） あまり必要ないもの だれが（Who） どこで（W

追憶の中に紡がれた言葉たち。 モノトーンの風景を照らすヘッドライトのような口跡。 それらは現実を呼び起こすのか、陽炎を見せるのか。 Webという名の漆黒の闇は 眠らぬ者をあざ笑うかの如く、言の葉を鎖につなぐ。 さあ、行こうか。 新たな戦いの地へ。