LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
LINEの社内には「テクニカルライティング」の専門チームがあります - LINE ENGINEERING
こんにちは、Developer Contentチームのmochikoです。LINE株式会社でテクニカルライターとして働いています。今日は「テクニカルライター」というお仕事と、LINEにあるテクニカルライティングの専門チームについてお話しします。 テクニカルライターという職種があります テクニカルライターって何をしてるの？何を書くの？ ドキュメントはどうやって書いてるの？ どんなメンバーで仕事をしてるの？ ドキュメントを書く以外にこんなこともしているよ でもドキュメントを書くだけだと技術力が下がらない？ どんな人がテクニカルライターに向いてるの？ テクニカルライターという職種があります 私はもともとウェブ制作会社のインフラエンジニアでした。とある技術書を書いたことをきっかけに「テクニカルライターとして一緒に働きませんか？」と声をかけてもらい、LINEへ転職するに至ったのですが、実はお誘いをい
「電子書籍よりも、読むならやっぱり紙の本」と信じる大人に、今知って欲しい子どもたちの話 (1/2) - ITmedia エンタープライズ
秋と言えば「読書」の秋。読者の皆さんは、最近「本」を読んでいますか？ ちょうど今は、2018年の読書週間（10月27日～11月9日）ですが、先日、知人から本にまつわる面白いデータを紹介してもらいました。 進研ゼミでおなじみ、ベネッセコーポレーションの研究所が、子どもたちの読書履歴と学力テスト、アンケートの結果から「読書量が多い子どもほど、学力が伸びている」という結果を導き出したという内容です。 （参考） 読書履歴を活用したデータ分析|ビッグデータを活用した教育研究│特集│ベネッセ教育総合研究所 特に興味深いのは、特に学力の伸びた分野が、国語ではなく「算数」だったという点。算数が苦手な子ども（そして、かつて子どもだった皆さんも）は少なくありませんが、今回の研究結果では、小学5～6年生の子どもたちのうち、読書量が多かった（1年4カ月の間に10冊以上読んだ）子どもは、国語、算数、理科、社会の4科
日本語の編集をしていてよく直すパターン19選 - 壁に飾られた絵画を見ようとしてその絵に近寄ってはいけない
ばるぼらさんと、ラムダノートの鹿野さんが、「日本語の校正・編集」という観点で「直すパターン」を挙げていらっしゃいました。だいたい同じことをやっているなぁ……と思ったので、乗っかりまして、自分でも列挙してみたいと思います。いくつ増えるかな。→4つ増えました。 注：この記事は「良い文章の書き方」ではなく、「編集や校正でどこを見ているか」のまとめです。 校正のバイトをしててよく直す箇所10選｜bxjp｜note k16's note: 日本語の編集をしていてよく直すパターン15選（増えるかも） 1. 順接の「が」が頻出する 順接の「が」は私も殲滅したい派です。逆接に受け取られる可能性を少しでも減らすためです。 2. 「も」を使いがち なぜか割と登場する「も」。使い勝手がいいのかもしれません。「また、●●も～」という文章は「また、●●は～」に直してしまいがちです。 3. 「することができる」を使い
校正のバイトをしててよく直す箇所10選｜bxjp
時々、校正・校閲の仕事をバイトでやっています。主に、文字・文法の間違いを正すのが校正、文章内容の事実関係の間違いを正すのが校閲、です。 校正の仕事の中心は、誤字脱字衍字や助詞（「てにをは」など）の修正ですが、「それ以外も気になったところは赤字を入れてください」と言われる場合があります。そうして見ていくと、たびたび手を入れる箇所、定番の直しというのが浮かんできました。 ここでは文章を書く人に向けて、「別に直さなくてもいいかもしれないけど、気をつけた方が読みやすい文章になるんじゃない？」というのを10コ選びました。ワタシは校正を「文章の間違いを無くす」だけでなく「文章を読んだときの違和感を無くす」ものだと考えています。なので、他の人だったら直さないかもしれないものもあります。あくまで目安として読んでください。先に項目だけ抜き出します。 1. 順接の「が」が頻出する 2. 「も」を使いがち 3.
はじめての論文執筆 - お茶の水女子大学 理学部情報科学科 伊藤研究室 ゼミ資料
はじめての論文執筆 お茶の水女子大学 理学部情報科学科 伊藤研究室 ゼミ資料 2018 年3 月 22 日公開開始 2020 年12 月11 日現在の資料 本文書は、論文執筆に関する研究室ローカルルールについてまとめた文書です。論文全体の構成から、 形式的な注意点、原稿を再利用するときのチェックポイントなどについてまとめました。 本文書の主な対象者は、情報系研究室に配属して1 年以内の学生、および後輩の原稿を添削する先輩学 生（主に大学院生）です。 なお本文書では以下の内容は扱いません。 ・ 研究内容の課題発見や問題解決そのものについての議論 ・ 英語特有のチェックポイント（別のゼミ資料） ・ 学位論文特有の注意点（http://itolab.is.ocha.ac.jp/~itot/message/msthesis.html 参照） 1. 研究論文の概略的な構成 伊藤研の研究分野にて学会等
Google Driveの魔法機能がすごい 画像の文字を書き起こす
Google Driveは、写真や文章、イラストなどを保管できるオンラインストレージサービス。15GBまで無料で使えるため、データの保存・共有用に使っている人もいるだろう。 そんなGoogle Driveの、意外と知られていない機能が話題になっている。Google Driveに画像をアップロードし、その画像をGoogle ドキュメントで開くと、画像の文字をテキストデータ化してくれるという。 手順はこうだ。まず、PCで文字起こしをしたい画像をGoogle Driveにアップロードし、その画像を右クリック。「アプリで開く」から「Google ドキュメント」を選択して開けば終了。対応ファイル形式は「JPEG」「PNG」「GIF」「PDF」。 最適な状態で書き起こすには、ファイルサイズを2MB以下にし、テキストの高さを10ピクセル以上に。画像の向きが間違っている場合は回転させてからアップロードし、
《第65回》文部科学大臣賞作品紹介（1）
第65回全国小・中学校作文コンクールの中央最終審査会が行われ、各賞が決定しました。応募は3万5095点（小学校低学年4883点、高学年8081点、中学校2万2131点）。文部科学大臣賞3点を要約して紹介します。（敬称略） <2015年11月30日の読売新聞朝刊に掲載しました> ＜中学校＞ 「夢の跡」 静岡・静岡サレジオ中２年 高田愛弓（たかだ・あゆみ） 父が、逮捕された。 自宅には家宅捜索が入った。毎日「いってきます」と「ただいま」を繰り返す門扉は、マスコミ陣で埋め尽くされた。 ２０１５年５月２６日、夕刻のことである。 ６人の警官が玄関先で卵のパックに収まっているかのように待機する中、母は親戚に電話をして、駅前のビジネスホテルを押さえてもらうと、祖母に連絡を取り、そこから叔母が私を迎えに行くように手筈（てはず）を整えた。 テレビドラマでしか観（み）たことがないようなことが自分の家で起こって
文章を書くときに気を付けているたった一つの簡単なこと。 - 大学職員の書き散らかしBLOG
以前弊BLOGでは公文書の書き方について言及しましたが、当該エントリーには未だにアクセスをいただいています。私と同じように、公文書の書き方に苦慮している方も少なくないのでしょう。そこで本エントリーでは、日頃私が文章を書くときに気を付けていることについてお話しします。それはたった一つ、しかも誰でもすぐに意識できることなんです。 「A、B、C。」という文章構造ならば「A、C。」としても意味が通じること これだけです。 これはどういうことなのか、弊BLOGのエントリーを使って解説していきます。 弊BLOGでは自分が参加した一部のセミナーやシンポジウムなどの会議録を掲載しています。 会議録を作って公表していると、自分自身の中の知識が再構成されていくのを感じます。 原則として、文章は"1sentence,1meaning"であるべきだと考えます。前回のエントリー内にあるこの二つの文章は読点が0もしく
【事→こと、時→とき】素人さんの原稿にありがちな平仮名にしたほうが読みやすい文字
たられば @tarareba722 仕事で素人さんの原稿のチェックをしているんですが、特別な事情がない限り、「事→こと」、「物→もの」、「１つ→ひとつ」と、とりあえずこれらを開くだけで原稿がずいぶん読みやすくなるということは、もっと周知されてほしい。 2015-05-15 20:01:52 たられば @tarareba722 編集者／だいたいニコニコしています／Fav→／大屋雄裕／鴻上尚史／東浩紀／士郎正宗／西原理恵子／伊坂幸太郎／みなもと太郎／中村珍／リアル脱出ゲーム／まどマギ／嵐／おかざき真里／ゆうきまさみ／羽海野チカ／末次由紀／小山宙哉／内藤泰弘／篠原健太／清少納言／羽生結弦／FGO／葦原大介／杉田圭／山本淳子／御用はリプ→DMで
平成２６年度大阪市立大学授業関係の連絡
授業関係の連絡 ・大阪市立大学文学部 平成２６年度授業について 「表現文化論特論」「表現文化特論I」（後期水曜日３限） 14-12-17 「表現文化論特論」「表現文化特論I」レポート課題 文化的生産物の「オリジナリティ」と「模倣」、およびそれを統御する制作主体との関係について新たな角度からの視点を獲得するために、文章テキストの作成過程に特殊な制約を設けた下記の課題を受講生に課することとする。 以下の二つのテーマの両方について、レポートを作成し提出せよ。 テーマ１：「佐村河内事件に思う」という題名を付し、この題名に即した内容のレポートを作成せよ。その際、下記の執筆条件に厳密に従いつつ行うこと。（2000字程度とするが分量超過は構わない） テーマ２：テーマ１のレポートを作成した過程を振り返って、自由に感想を述べよ。（1000字以上で分量自由） テーマ1の執筆条件：（以下の条件を満たさないと判
「テーマ」と「論点」は違う - bluelines
この本に書いてあることなんですけどね。今日、学生と話していたので。 伝わる・揺さぶる!文章を書く (PHP新書) 作者: 山田ズーニー 出版社/メーカー: PHP研究所 発売日: 2001/11 メディア: 新書 購入: 49人 クリック: 391回 この商品を含むブログ (224件) を見る （ちなみに、この本は間違いなく、大学生が手元に持っておく価値がある「書き方」の本のひとつです） 大学生がレポートを書くときに、何らかの「テーマ」について書こうとすることがよくあります。間違いです。レポートなり、論文なり、その他の文章を書くときは、そのテーマに関する「論点」が必要なのです。 具体例。 テーマ：「日本の英語教育について」 論点：「小学校で英語を教えるべきか？」「高校の英語は英語で教えるべきか？」「大学入試を四技能型試験にするべきか？」... 論点は、問いです。疑問文です。その問いに対して
文章の書き方を変えるだけで社内の情報共有は加速する - UNIX的なアレ
社内の情報共有で困っている会社は多いみたいですね。でも実は、nanapiという会社ではそこまで困っていなかったりします。元々文章を扱う会社というのもありますし、ドキュメント化して共有しようという風土が染み付いているからだと思います。 そういったこともあり最近登壇するときなど、社内の情報発信などについて話す機会が増えました。弊社では社内における情報共有のツールとして、Qiita:Teamを使用しています。 生産性を向上させる情報共有ツール - キータチーム（Qiita Team） 全員がMarkdownで文章を書く 実際にnanapiではQiita:Teamを導入してから、現在ではエンジニアだけでなくアルバイトも含めた全社員がここに様々なドキュメントを投稿しています。 Qiita:TeamはMarkdownで書けるようになっています。つまり、社内のメンバーは全員がMarkdownで文章を書く
伝わる文章を書くために重要な「200字の法則」 | ライフハッカー・ジャパン
『200字の法則 伝わる文章を書く技術』（向後千春著、長岡書店）が定義づける「200字の法則」とは、200字で的確に自分の考えを伝えられるように書くこと。200字を書けるようになれば、「あとは何千字、何万字の論文でも、1冊の本でも書けるようになる」と断言しています。 では、「伝わる文章」を書くためにはどうしたらいいのか？ 第2章「200字の法則で、読ませる文章を書く！」から要点を引き出してみます。まずは、"ダメどころ"のチェックから。 自分の文章の"ダメどころ"をチェック！ 次の項目の当てはまるところにチェックを入れると、自分の文章のダメどころが確認でき、意識的に改善することができるといいます。 □ 書く以前に、何を書けばいいのか頭が真っ白になる □ 出だしが書けずに、時間ばかりがたってしまう □ 「です、ます」「である」など、語尾をどうすればいいのか迷う □ つなぎの言葉がうまく使えず、
専門的な文章を読むには訓練が必要という当たり前だがあまり知られていないこと｜Colorless Green Ideas
専門家はお互いにとって理解しやすくするために、専門用語を使って文章を書く。こうした専門的な文章を理解するにはしっかりとした訓練が必要である。 はじめに 西日本新聞のウェブサイトに掲載されたコラムに次のような文章があった。 ネット上に公開された大学などの論文にある「解釈的文脈」「モダリティ辞」「ディアスポラ」「語用論」って何？ 高度な論文でなければ注目されず、不勉強と冷笑されもするだろうが、難解な言葉で自己陶酔する世界観が学術界に広がっていないだろうか。 本来、研究は人、社会に役立つべきものと思うが、ネット上の論文には個人的な知的遊戯に浸っている物が少なからず散見される。 田端良成 （2014年3月23日）「ＳＴＡＰ細胞をめぐる一連の大騒動」『西日本新聞』 http://www.nishinippon.co.jp/nnp/desk/article/77391 この指摘は妥当なものでない。研究
「無断引用」という表現はやめよう｜Colorless Green Ideas
他人の文章を自分の文章のように扱う研究上の不正は、「剽窃」または「盗用」と呼ぶのが正確であり、不正確で誤解を招く「無断引用」という表現を用いるのはやめるべきである。 「無断引用」という表現はよろしくない 小保方晴子氏が他者の文章を自分の論文に盗用したという事件 [1] があった。この事件の報道において「無断引用」という表現が各所で用いられているが、この表現は正確でなく誤解を招きやすいので、使うのはやめるべきだと思う。「無断引用」の代わりに、「剽窃（ひょうせつ）」か「盗用」と言ってほしいところだ [2] 。 引用という行為は、引用の作法を守っているかぎり、法的にも倫理的にも何ら問題のない行為である。そして、引用は基本的に無断で行われる。わざわざ出典の著者の許可をとらないのである。つまり、無断で行われる引用は全く正常な行為であり、研究上の不正ではない。 研究上の不正になるのは、他人の文章を自分
Word文書が消えてやる気をなくした方へ ―消えたWord文書の回復法 - 文章の危機管理コンサルタントが日本語について考える
Wordが突然フリーズしたり、勝手に異常終了したりで、 「ここまで書いたものが消えちゃった・・・」 なんてこと、ありませんか。 いっきにやる気なくしますよね。 自動回復の機能もありますが、 （10年前の文書を回復してほしいんぢゃないよっ） それが効かないとき、もう死にたくなります（大げさ）。 Word の[バックアップファイルを作成する] 設定で、 作成中のファイルのバックアップが残っている場合は、 「.wbk」という拡張子のファイルがあります。 それもないときは・・・ 自棄になる前に、この方法をお試しあれ ■「*.ASD」ファイルを探す 私はたいてい、これで救われます マイコンピューターあたりを対象に、つまり、 （システムが勝手にファイルを保存しそうな場所を対象に） 広域に検索をしてみてください。 作成していたファイル名＋.asd（「○○○.asd」）が 見つかれば・・・おめでとうござい
「原稿を書いては消ししている」という状況を解決するには - 西尾泰和のはてなダイアリー
「原稿を書いては消し書いては消ししていて全然進まない」という話をよく聞きます。 これって「よくない精神状態」にハマり込んでいると思います。 考えてみましょう。人間が脳内で保持できる情報はどれくらいでしょう？原稿に文章Aを書いて、しっくりこないので消して、文章Bを書いた後で、文章Aのことをどれくらい覚えていますか？文章Aを書いている時に何を伝えることが重要だと考えていたか覚えていますか？ 「書いて消して」を繰り返している間、時間は消費されていますが、何も蓄積されていません。何も蓄積されないのであれば、問題はやさしくなったりはしません。ずっと同じ難易度のまま、あなたの前に立ちふさがり続けます。 原稿と戦っているうちに視野が狭くなって、自分が「よくない精神状態」にハマり込んでしまっていることを自覚できなくなるのは怖いことです。さらにはTwitterで愚痴ったり、ネットサーフィンをしてこんなサイト
「切込隊長が、やまもといちろうになるまで」--ウェブ時代の文章読本より : Blog @narumi
2014年01月08日10:30 「切込隊長が、やまもといちろうになるまで」--ウェブ時代の文章読本より https://narumi.blog.jp/archives/2169543.html「切込隊長が、やまもといちろうになるまで」--ウェブ時代の文章読本より 「ブロガーに学ぶウェブ時代の文章技術論」といったテーマのイベントについてメモったもので、前回の続きです。 ゲストは「やまもといちろうBLOG」のやまもといちろう氏と、「小鳥ピヨピヨ」の清田いちる氏。この2人の話をライブドアブログの事業責任者・佐々木大輔氏と、日経BPの編集者・竹内靖朗氏がいろいろ聞き出しています。やまもといちろうさんの昔のブログを読み解いたり、歴代人気記事ランキングがすごいという内容です。 ◆◆◆ 佐々木：やまもとさんが、目の前で書いているところを1回見たことがあって、2時間くらいの、クライアント名を出していいか
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ナンプラーで南国風に なすのそうめん | 大手小町
