並び順

ブックマーク数

期間指定

  • から
  • まで

1 - 40 件 / 224件

新着順 人気順

ライティングの検索結果1 - 40 件 / 224件

  • LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた


    LINE2023101LINELINE LINE Tech Blog Developer ContentLINE1 6mochikoLINEmochikopv LINELINE沿1
      LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
    • テクニカルライティングの基本


       Twitterhttps://twitter.com/naoh_nak 2023https://speakerdeck.com/naohiro_nakata/technicalwriting2023
        テクニカルライティングの基本
      • 質の高い技術文書を書く方法 - As a Futurist...

        大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは? 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体

          質の高い技術文書を書く方法 - As a Futurist...
        • VOICEVOX | 無料のテキスト読み上げ・歌声合成ソフトウェア

          オープンソースVOICEVOX は OSS(オープンソース・ソフトウェア)版 VOICEVOX をもとに構築されています。 製品版と OSS 版の違いやモジュール構成は VOICEVOX の全体構成 をご参照ください。 ソフトウェア部分は Electron + Vue 、音声合成エンジン部分は Python + FastAPI です。 追加したい・改善したい機能があれば、ぜひ開発にご参加ください。

          • Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita


             20   https://developers.google.com/tech-writing Every engineer is also a write
              Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
            • なんとなく使っていませんか? 括弧の種類と使い分け|モリサワ note編集部


                      https://www.aozora.gr.jp/cards/000081/files/43737_19215.html     使 
                なんとなく使っていませんか? 括弧の種類と使い分け|モリサワ note編集部
              • フルリモートで相手に気持ちよく仕事をしてもらうためのコツあれこれ

                社内のプチ発表に使った資料です。 文章のコツ 前置き フルリモートでは、文章でのやり取りがメインになる。 なので、文章がヒドいと「この人と仕事するのキツイ」と思われちゃう😢 そう思われないための色々思ったことを自戒メモ。 なるべく箇条書きにする

                  フルリモートで相手に気持ちよく仕事をしてもらうためのコツあれこれ
                • プレゼンスライドがみるみる良くなる基本の推敲技術 -事例付き解説-|石原尚(大阪大学教員)|note


                  202110   使
                    プレゼンスライドがみるみる良くなる基本の推敲技術 -事例付き解説-|石原尚(大阪大学教員)|note
                  • 桃太郎なのに、とっても Apple


                        Hello, Momotaro.    4300 
                      桃太郎なのに、とっても Apple
                    • 小学生に教えるために編集者歴17年の父親が本気で考えた…「きちんと伝わる文章」を書く10のコツ 「説明ができる」とは「生きる力がある」ということ

                      「伝わる文章」とはどのようなものか 私はWEB媒体の編集者/ライターをかれこれ17年ほどやっている。日本語で情報を伝えるのが仕事だ。 ジャンルとしては長文の体験レポートを中心に扱ってきた。ライトな読み物で、書くのも簡単そうだと思われるかもしれない。いやいや、そうでもないのだ。それぞれのバックグラウンドを持ち観察力に優れた書き手が、五感をフルに使い数時間かけて体験取材をすると、情報量がとんでもないことになる。それを限られた字数で読者にわかりやすく伝えるのは、実は技術のいる作業なのだ。 また、私は特に編集部の中でも新人ライターを多く担当しており、書き慣れない人が書いた文章を一緒に直し、読み手に伝わる書き方をアドバイスする経験をずっと積んできた。 そんな私が、小学生の子供の中学受験によってあらためて「伝わる文章の書き方」を見つめ直すことになった。本稿ではその経験について少し語らせてほしい。

                        小学生に教えるために編集者歴17年の父親が本気で考えた…「きちんと伝わる文章」を書く10のコツ 「説明ができる」とは「生きる力がある」ということ
                      • 意外と知られてない、すごく効果のある文章上達法|ふろむだ@分裂勘違い君劇場


                                   2 (1)
                          意外と知られてない、すごく効果のある文章上達法|ふろむだ@分裂勘違い君劇場
                        • なぜ「事実」と「意見」を区別して話せない人がいるのか。

                          ちょっとまえ、面白い記事をツイッターで拝見した。 企業の採用担当が、面接時に見ているポイントを端的に表現したものだ。 曰く、「事実と意見を分けて説明できるかは圧倒的に重要で、これができない人はかなり厳しい。」とのこと。 クローズな勉強会などで話をしたら好評だったのでブログに書きました / 面接時に見ているポイント – VOYAGE GROUP techlog https://t.co/64ehNAYLAi — Masanori KOGA (@makoga) October 29, 2019 彼がこれを重視する理由としては 「事実と意見を分けて説明するのがうまい人が書いた障害報告書は読みやすい」とある。 確かに読みやすい文章を書く人は、知的能力が高い事が多いので、採用の精度は良いのではないかと推測する。 ただ、この文章を読んで感じるのは、 「なぜ「事実」と「意見」を区別して話せない人がいるの

                            なぜ「事実」と「意見」を区別して話せない人がいるのか。
                          • テクニカルライティングの基本 2023年版

                            テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter:https://twitter.com/naoh_nak 2022年版(初版):https://speakerdeck.com/naohiro_nakata/technicalwriting

                              テクニカルライティングの基本 2023年版
                            • 文才の有無に関係なく、誰でもそれなりに整った文章を書くコツ|村井 弦|文藝春秋


                                9 10  note 
                                文才の有無に関係なく、誰でもそれなりに整った文章を書くコツ|村井 弦|文藝春秋
                              • 伝わる文章 | 基本要素 | SmartHR Design System


                                 SmartHR     1 Before
                                  伝わる文章 | 基本要素 | SmartHR Design System
                                • 「うちはそういうのやってないから」|春名風花|note


                                        ( ´˙˙ )   
                                    「うちはそういうのやってないから」|春名風花|note
                                  • コロナに乗じて町内会の属人業務を改善しまくった一人のおばあちゃんの話

                                    町内会のおばあちゃんの話をします。 しんざきは町内会というものに所属しています。 以前マンションの理事長に持ち回りで就任した時、セットで町内会にも所属することになりまして、それ以降なにやかやでちょくちょく顔を出すようになりました。 町内会の青年団というものに「青年」など一人も所属しておらず、40歳のおっさんである私がほぼ最年少だ、ということにショックを受けたりもしていました。 この年になって「十数人のグループで最若手」になる機会があるとか、思ってませんでしたよ正直。 この町内会に、いつも電動自転車で町内を軽快に走り回っている、一人の名物おばあちゃんがいます。 もう御年は80歳を何年か過ぎていらっしゃると思うんですが、一時期体調を崩しつつもおおむねお元気で、物凄く新しい知識に貪欲で、ITスキルについても全く抵抗感というものがなく、町内会で数々の業務改善を成し遂げてきた凄いおばあちゃんでして。

                                      コロナに乗じて町内会の属人業務を改善しまくった一人のおばあちゃんの話
                                    • 【更新】創作する人は必読!書評家が下読みで感じた「応募小説の問題点」がめちゃくちゃタメになる

                                      杉江松恋@5/3博麗神社例大祭し29-a @from41tohomania 職業は書評を中心としたライター業です。東方project奮戦中につき、ツイートは東方成分多し。現在は地霊殿中です。普通の日常報告についてはブログでどうぞ。他に言及する話題は古典芸能や、翻訳ミステリーについてなど。フォローもリムーブもご随意に。【新規】ゲラなどの送付物はプリントアウトでいただけると助かります。 mckoy.cocolog-nifty.com/hansei/ 杉江松恋@3/31東方名華祭A-06 @from41tohomania 下読み中。すごもり生活の反映なのか、作者の私生活をそのまま描いたものが散見される。でもね、あなたがよほどの有名人ではない限り、私生活は平凡で退屈な題材なのです。日常をそのまま書いておもしろい作品は存在するが、それは文章が素晴らしいから。文章の天才でないのなら物語性で工夫しないと

                                        【更新】創作する人は必読!書評家が下読みで感じた「応募小説の問題点」がめちゃくちゃタメになる
                                      • 文科省の公用文作成の考え方って資料、めちゃくちゃ役立つから論文書く人とか社会人になって社外にメールを送るのが苦手って人は読むのをおすすめする。

                                        ぎーち(ブレイク兄) @BREAK_BROTHER 小型衛星の電源屋さんでヤンス。趣味でも衛星開発やっとります。衛星に携わってる方はぜひ仲良くしてクレメンス… 東方サークル(ネタタイトル萌えジャケットガチクラシック人工衛星サークル)"Windbreaker"のネタタイトル人工衛星担当です。アイコンはかじつおひま様、ヘッダーは人間猫様に描いていただきました! twpf.jp/BREAK_BROTHER リンク Yahoo!ニュース お願い「致します」漢字はNG? - Yahoo!ニュース 「よろしくお願いいたします」ビジネスメールでは常套句ともいえる一文に注目が集まっている。きっかけはX上のあるユーザーの投稿。そのユーザーは「よろしくお願いいたします」の「いたします」部分について、ひ 3 users

                                          文科省の公用文作成の考え方って資料、めちゃくちゃ役立つから論文書く人とか社会人になって社外にメールを送るのが苦手って人は読むのをおすすめする。
                                        • Amazonの従業員が学ぶ伝わる文章構成の極意|Sangmin Ahn

                                          こんにちは、Choimirai School のサンミンです。 【主要なアップデート】 (2023.10.01)ベゾス氏がパワポを禁止した理由を語った動画を追加 (2020.05.11)Blitzscaling、ビル・ゲイツのコメントと英語版リンクを追加 (2020.05.11)知的生産の技術に関するコメントを追加 0  はじめに ▲アマゾンの社内プレゼンテーションで、パワーポイントの使用が禁止されているのは、かなり有名な話。 会議では、冒頭のおよそ15~20分間、参加者全員にドキュメントを読むための時間があてられる。ドキュメントは6ページと長い場合も多く静まったミーティングルームで参加者が黙々とドキュメントを読む雰囲気はかなり緊張感が漂っている。

                                            Amazonの従業員が学ぶ伝わる文章構成の極意|Sangmin Ahn
                                          • スケベ小説を書くときの参考書・ツールまとめ


                                             @wamekukyouzin 使Twitter 2022-01-01 23:31:21  @wamekukyouzin 使 使  2022-01-01 23:31:42
                                              スケベ小説を書くときの参考書・ツールまとめ
                                            • 読みやすい文章のために、極力削るべき言葉リスト|桜川和樹

                                              最近note書く人増えましたね。新年を迎え、新たに始めてみようって人も多いんじゃないでしょうか。 仕事で文章チェックしていて、削ったほうがスマートになる言葉をいくつか書き溜めてきたので、文章デビューする人のために一挙放出しちゃいます。 「私」「僕」などの一人称 あなたが書いてることはわかっているので、入れなくても伝わる流れであれば削ってOKです。 mina最新号の表紙タイトルを見て、僕ははっとした。 ↓ mina最新号の表紙タイトルを見てはっとした。「と思う」「気がする」 日本人の特性なのか、言い切らずに「〜だと思います」を多用する人は多いです。思い切って削っちゃいましょう。 人生において、言葉が余計な瞬間ってある気がします。本当に心揺さぶられたとき、言葉を重ねることほどナンセンスなことはないと思います。 ↓ 人生において、言葉が余計な瞬間ってあります。本当に心揺さぶられたとき、言葉を重ね

                                                読みやすい文章のために、極力削るべき言葉リスト|桜川和樹
                                              • わかりやすい説明のための 10 の鉄則

                                                第0部 まずは「分かりづらい説明」を知ろう(p.14~) 第1部 口頭説明編(p.25~) 第2部 資料作成編(p.63~) 第3部 スライド作成編(p.81~) スライドのまとめ(p.115~)

                                                  わかりやすい説明のための 10 の鉄則
                                                • デリヘル嬢してた時に、こんなお客さんいたなっていう思い出。


                                                  21 宿 
                                                    デリヘル嬢してた時に、こんなお客さんいたなっていう思い出。
                                                  • 執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら

                                                    中村明博(編集者) @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、! 2021-03-05 12:14:24 中村明博(編集者) @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 2021-03-05 14:37:22 中村明博(編集者) @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人

                                                      執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら
                                                    • 『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech

                                                      理科系の作文技術(リフロー版) (中公新書) 作者:木下是雄発売日: 2016/10/14メディア: Kindle版 いまさら紹介するまでもないけど、とりあえず作文方法を学びたい時は、まずはこの「理科系の作文技術」を読むことをお勧めする。 最近ブログのエントリをざっと書いてそのまま公開してしまうことが多かったので、少し反省し、それを直すためにこの本を改めて読み直した。そうしたら、タイトルで全部言い切っているのだけど、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った。 日常的にメールや、ブログの記事など、それなりの量の文章を書くことが多いけど、論文や雑誌の記事など、きちんと他人の目を通した上で公開される文章を書くことは、まずない。一度だけ、雑誌の記事原稿を書いたとき、自分なりにかなりの推敲を重ねたつもりでも、プロの編集の方から見れば言葉使いや、

                                                        『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech
                                                      • 一家に一冊、『批評理論入門―『フランケンシュタイン』解剖講義』廣野由美子 (中公新書) - ゴールデンレトリバー撫でたい

                                                        (※再公開です) 批評理論入門―『フランケンシュタイン』解剖講義 (中公新書) 作者:廣野 由美子 発売日: 2005/03/01 メディア: 新書 批評ブログやりたいわけじゃないんだけど、物語作品の考察なり分析なり書こうとするとどうしてもこういうところの参照が要請されるので再確認のためにも出してきました。 日本の読書文化が誇る中公新書における名著の1つなので今更感はあるけど、こういうのは書いとくに越したことはないでしょう。今はこんなのも電子版出ててすごいね。 題名は「批評理論入門」となっているけど、思い切って言えばこれは「小説の読み方」を教えてくれる本です。もちろん映画でもアニメでも物語ならなんでも役に立つ。このジャンルの入門書でこの本を越えるものは令和3年の今でもおそらくまだない。入門書と言っても何度も読み返すに値する深みを持っている、正しく新書版の名著と呼ぶにふさわしい本です。 1.

                                                          一家に一冊、『批評理論入門―『フランケンシュタイン』解剖講義』廣野由美子 (中公新書) - ゴールデンレトリバー撫でたい
                                                        • 「ほんとに教えてくれていいの?」あの有名映画はどこから照明が当たってたか真上から図解してくれるアカウントが有益すぎる

                                                          Gary's娘@MUSUMETAL @garys_daughter 見てみたら概ね合ってるし、こうだろうなという予測の部分も参考になる。 洋書を扱う書店のデザイン、芸術棚を探すと、こういう解説だけ仕様機材も含めて図解した海外フォトグラファー専門書がたくさんある\( 'ω')/ 日本の写真館セオリーとアプローチが全く異なるライティングが多くて勉強になるのっ twitter.com/cm12151054/sta… 2021-11-08 14:25:44

                                                            「ほんとに教えてくれていいの?」あの有名映画はどこから照明が当たってたか真上から図解してくれるアカウントが有益すぎる
                                                          • ドキュメントに固執せよ - gfnweb

                                                            どうして人間集団はこんなにも知見の共有を円滑にできないのか? 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい. ここでテーマにしているのは,著名OSSなど世の中にいくらでも知見が転がっている対象ではなく,特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである. 非常に乱暴な言い方をするなら,「コードとか大部分は誰でも書けるようになるものなんよ,そんなところにマッチョイズムとか感じなくてええねん,我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム(ソフトウェアなど)について,そのシステムのことを全く知らない人を想定読者としたドキュメント

                                                            • 離乳食提供開始の反響を受けまして | Soup Stock Tokyo(スープストックトーキョー)

                                                              4月25日に開始した「離乳食後期の全店無料提供」の取り組みに対して、さまざまなお声をいただきました。 お声を受けてからの発言を控えておりましたのは、私たちの存在意義について想いを巡らせ、考えを深めていたからです。 改めまして、私たちがどのような想いでこの取り組みをはじめたのか、何を実現したいのかを私たちの言葉でお伝えしたいと思います。 ―――――――――― 私たちスープストックトーキョーの企業理念は、「世の中の体温をあげる」です。 スープという料理を通じて身体の体温をあげるだけではなく、心の体温をあげたい。 そんな願いを一杯のスープに込めた事業を行っています。 その理念のもと、さまざまな理由で食べることへの制約があったり、自由な食事がままならないという方々の助けになれればと「Soup for all!」という食のバリアフリーの取り組みを推進しています。 これまでの取り組みでは、 ・グルテン

                                                                離乳食提供開始の反響を受けまして | Soup Stock Tokyo(スープストックトーキョー)
                                                              • 英語の括弧は4種類ある!括弧の使い方を理解して正しく使えるようになろう | English Lab(イングリッシュラボ)┃レアジョブ英会話が発信する英語サイト


                                                                使使使 使使4使 English Lab1142 4 使
                                                                  英語の括弧は4種類ある!括弧の使い方を理解して正しく使えるようになろう | English Lab(イングリッシュラボ)┃レアジョブ英会話が発信する英語サイト
                                                                • 社員用に作った文書校正ツールを一般公開した - gecko655のブログ

                                                                  スクリーンショット これはなに 会社で「PR用の文章を人力でチェックする工数が重くて、めっちゃ残業が発生している。なんとか自動化できないか」との依頼を受け、Word等のファイルをGUIでそのままtextlintできるツールをちゃちゃっと作って社内公開しました。その結果、いい感じに社内で有効利用してもらうことができたので、外部公開に踏み切ることにしました。 github.com インストール&設定 1. インストーラーでツールをインストールする GitHub上で配布しています。 https://github.com/gecko655/proofreading-tool/releases Mac版で「開発元が未確認のため開けません」が出た方へ https://support.apple.com/ja-jp/guide/mac-help/mh40616/mac を参考に、アプリケーションをセキュ

                                                                    社員用に作った文書校正ツールを一般公開した - gecko655のブログ
                                                                  • Apple 風文体の力を、あなたにも。


                                                                      調  anond:20210424193915
                                                                      Apple 風文体の力を、あなたにも。
                                                                    • 誰がどう見てもそうとしか受け取れない文書術(公開版)

                                                                      サービシンクの名村が25年に渡るWeb制作のプロジェクトマネジメントで「テキストで情報を伝える」上で認識齟齬に至る点を洗い出した「誰がどう見てもそうとしか受け取れない文書術」のセミナースライドの2020年3月29日公開版です。 Web制作・システム開発に関わる人以外には事例等が分かりにくいかもしれませんが、日本語の弱点とそれを補うためのコツと答えを記載していますので、何かの参考になれば幸いです。

                                                                        誰がどう見てもそうとしか受け取れない文書術(公開版)
                                                                      • 表記揺れ検出ツール「テキストゆれないくん」 - inzkyk.xyz

                                                                        その他のサンプル: Wikipedia:良質な記事, Wikipedia:長いページ 紹介 「テキストゆれないくん」は文章に含まれる表記揺れを検出するツールです。「コンピュータ」と「コンピューター」、あるいは「全て」と「すべて」といった同じ単語の別表記が使われていないかどうかをチェックできます。 「テキストゆれないくん」は元々このサイト (https://inzkyk.xyz/) の文章校正用に開発されました。機能が成熟してきたので UI を付けて公開します。 このページから手動で使う限り、「テキストゆれないくん」は商用/非商用を問わず自由に使って構いません。「テキストゆれないくん」は無保証で提供されます。 特徴 ウェブブラウザから使える このページをウェブブラウザで開いているなら、「テキストゆれないくん」は既に動いています。このページの最初にあるのは「テキストゆれないくん」を使うための完

                                                                          表記揺れ検出ツール「テキストゆれないくん」 - inzkyk.xyz
                                                                        • 正解などない読書感想文の、正解と言える書き方


                                                                          8 34    
                                                                            正解などない読書感想文の、正解と言える書き方
                                                                          • 小学2年生の次女が、サクサク作文の宿題をこなせるようになった「技術」についての話。


                                                                             宿宿     宿 稿 400稿 
                                                                              小学2年生の次女が、サクサク作文の宿題をこなせるようになった「技術」についての話。
                                                                            • 恩師の下着に感謝


                                                                                          
                                                                                恩師の下着に感謝
                                                                              • プロとアマの小説の特徴を数値化して比較してみたらやっぱり差があったので、それを埋めるための型付き小説記述用言語 TypeNovel を公開した件について - anti scroll

                                                                                ラノベのタイトルみたいな記事を書く、という夢が叶いました。 github.com 開発に至った動機 以前から、アマチュアの小説はプロに比べると、描写不足な傾向があるのかもしれない、と思っていました。 特に不足がちだと感じるのは「時間」に関する描写です。 季節がわからなかったり、昼か夜か、平日か休日かみたいなことが不明瞭な作品が多い気がします。 しかし印象だけで語ってもアレなので、実際に差があるのかどうかを計測してみました。 計算式は、 時間描写の文の数 * 時間描写分布のエントロピー / 文の数 です。 「時間描写分布のエントロピー」というのは「全体を通じて、どれだけ満遍なく時間表現が書かれているか」という数字だと思ってください。 例えば時間描写が冒頭部にしかなかったりすると数値が小さくなり、全編を通じて満遍なく描写されていると、数値が大きくなります。 あと時間描写というのは、一応「季節、

                                                                                  プロとアマの小説の特徴を数値化して比較してみたらやっぱり差があったので、それを埋めるための型付き小説記述用言語 TypeNovel を公開した件について - anti scroll
                                                                                • 「問題解決を、セクシーに。」小泉進次郎 Powered by Apple


                                                                                      30 301 303030 Siri2   Super Retina XDR3使 46305
                                                                                    「問題解決を、セクシーに。」小泉進次郎 Powered by Apple