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へ転職するに至ったのですが、実はお誘いをい
遠山 祐典さんのツイート: "Nature公式、論文要旨の書き方。 授業でこれを扱うと国籍問わず大半の大学院生が知らなかったと言うので簡易和訳版を作成。 もちろん、Nature以外の論文にも流用する事が可能。 注目は、[結果]に使える文の少なさ(2~3文。全体の20~25%)。 和訳の修正案、大歓迎です。 英語版:https://t.co/RQEbeOWoNX… https://t.co/zdu9I9J24b"
Nature公式、論文要旨の書き方。 授業でこれを扱うと国籍問わず大半の大学院生が知らなかったと言うので簡易和訳版を作成。 もちろん、Nature以外の論文にも流用する事が可能。 注目は、[結果]に使える文の少なさ(2~3文。全体… https://t.co/zdu9I9J24b
![遠山 祐典さんのツイート: "Nature公式、論文要旨の書き方。 授業でこれを扱うと国籍問わず大半の大学院生が知らなかったと言うので簡易和訳版を作成。 もちろん、Nature以外の論文にも流用する事が可能。 注目は、[結果]に使える文の少なさ(2~3文。全体の20~25%)。 和訳の修正案、大歓迎です。 英語版:https://t.co/RQEbeOWoNX… https://t.co/zdu9I9J24b"](https://cdn-ak-scissors.b.st-hatena.com/image/square/e5928c9459b4b1f72c8888e8d218bcab74ce6475/height=288;version=1;width=512/https%3A%2F%2Fpbs.twimg.com%2Fprofile_images%2F1600435512489422852%2FfOcRIQUb.jpg)
校正のバイトをしててよく直す箇所10選｜bxjp
時々、校正・校閲の仕事をバイトでやっています。主に、文字・文法の間違いを正すのが校正、文章内容の事実関係の間違いを正すのが校閲、です。 校正の仕事の中心は、誤字脱字衍字や助詞（「てにをは」など）の修正ですが、「それ以外も気になったところは赤字を入れてください」と言われる場合があります。そうして見ていくと、たびたび手を入れる箇所、定番の直しというのが浮かんできました。 ここでは文章を書く人に向けて、「別に直さなくてもいいかもしれないけど、気をつけた方が読みやすい文章になるんじゃない？」というのを10コ選びました。ワタシは校正を「文章の間違いを無くす」だけでなく「文章を読んだときの違和感を無くす」ものだと考えています。なので、他の人だったら直さないかもしれないものもあります。あくまで目安として読んでください。先に項目だけ抜き出します。 1. 順接の「が」が頻出する 2. 「も」を使いがち 3.
はじめての論文執筆 - お茶の水女子大学 理学部情報科学科 伊藤研究室 ゼミ資料
はじめての論文執筆 お茶の水女子大学 理学部情報科学科 伊藤研究室 ゼミ資料 2018 年3 月 22 日公開開始 2020 年12 月11 日現在の資料 本文書は、論文執筆に関する研究室ローカルルールについてまとめた文書です。論文全体の構成から、 形式的な注意点、原稿を再利用するときのチェックポイントなどについてまとめました。 本文書の主な対象者は、情報系研究室に配属して1 年以内の学生、および後輩の原稿を添削する先輩学 生（主に大学院生）です。 なお本文書では以下の内容は扱いません。 ・ 研究内容の課題発見や問題解決そのものについての議論 ・ 英語特有のチェックポイント（別のゼミ資料） ・ 学位論文特有の注意点（http://itolab.is.ocha.ac.jp/~itot/message/msthesis.html 参照） 1. 研究論文の概略的な構成 伊藤研の研究分野にて学会等
学術論文を書くときは Microsoft Word と LaTeX のどちらが効率的か？｜Colorless Green Ideas
実験内容 この研究で行われた実験では、学術論文の文書になっているものを被験者に提示し、それを Microsoft Word か LaTeX で再現するように求めている。 被験者は以下の4つのグループに分かれている。なお、初心者は使用経験が500時間以下の人を指し、熟練者は使用経験が1,000時間以上の人を指す。 Word の初心者 Word の熟練者 LaTeX の初心者 LaTeX の熟練者 各々の被験者には3種類の文書が与えられ、それぞれを30分で再現することが求められた。 単純な連続したテキスト 表を含むテキスト 数式を含むテキスト そして、被験者による再現は以下の3つの点で評価される。 正書法・文法上の誤りの数 フォーマット上の誤りの数 30分で入力した文章の量 結果 全般的に言えば、Word を使用した人の方が、LaTeX を使用した人に比べて誤りが少なく、入力した文章の量も多か
研究者として最低限知っておきたいデザインの基礎知識 (rev.20140821)
- 1 - 研究者として最低限知っておきたいデザインの基礎知識 ～日本語の発表ポスター制作のために～ 長谷 芳樹 ＊ Fundamental Knowledge for Designing Academic Posters in Japanese Yoshiki NAGATANI 1. はじめに 研究者にとって，学会や研究会の場で自らの研究成果を 発表することは，新鮮な知見・視点の発見や新たな共同研 究者との人脈形成，さらには研究資金獲得の面においても 極めて重要な機会である。特にポスター発表は参加者との 濃密な議論が期待できるものであり，単に成果を発表した という実績を一方的に得るだけのためのものではない。し かしながら，会場に座ってさえいれば次々と演者が入れ替 わる口頭発表とは異なり，ポスター発表では参加者にポス ターの前で足を止めてもらわない限り発表内容を伝えるこ とが出来ない。この
伝わる文章を書くために重要な「200字の法則」 | ライフハッカー・ジャパン
『200字の法則 伝わる文章を書く技術』（向後千春著、長岡書店）が定義づける「200字の法則」とは、200字で的確に自分の考えを伝えられるように書くこと。200字を書けるようになれば、「あとは何千字、何万字の論文でも、1冊の本でも書けるようになる」と断言しています。 では、「伝わる文章」を書くためにはどうしたらいいのか？ 第2章「200字の法則で、読ませる文章を書く！」から要点を引き出してみます。まずは、"ダメどころ"のチェックから。 自分の文章の"ダメどころ"をチェック！ 次の項目の当てはまるところにチェックを入れると、自分の文章のダメどころが確認でき、意識的に改善することができるといいます。 □ 書く以前に、何を書けばいいのか頭が真っ白になる □ 出だしが書けずに、時間ばかりがたってしまう □ 「です、ます」「である」など、語尾をどうすればいいのか迷う □ つなぎの言葉がうまく使えず、
【学生必読】手書きでノートを取る方が記憶にも残り理解も深まる：米大調査 - IRORIO（イロリオ）
パソコンやタブレットなど、記録を残すツールには事欠かないが、忘れたくないことはやはり“ペンで紙に書く”という、昔ながらの方法がベストらしい。 パソコンで記録するより、手書きでノートを取った方が授業の内容がわかる！ 米プリンストン大学の心理学者、パム・ミューラー女史は、65人の大学生に対し講義を行った際、どの様な方法で記録を残すと最も記憶に残るのか調査した。 30分の講義の後、学生たちが今聴いた内容をどれだけ覚えており、理解しているのか調べたところ、手書きでノートを取っていた学生の方が、パソコンで記録していた学生に比べ、講義内容についての理解度が高かった。 手書きのノートは記憶力にも吉！ また、たとえ記録したものを見直す機会がなくても、手書きでノートを取っていた学生の方が、後々まで講義内容をよく覚えていたとも。 「パソコン頼りの学習では、授業中のネットショッピングを促すだけでなく、成績に響く
アカデミック・ライティング — CELAS
大学に入ると多くの科目でレポート課題がでます。また、基礎セミナーやゼミで発表用のレジュメを作る必要もでてきます。このような、大学で求められる学術的な文章を書くことを、アカデミック・ライティングといいます。 しかし、新入生の多くはそのような文章を書いた経験が乏しく、不安に思っているのではないでしょうか。「○○について、４０００字でレポートを書きなさい」とか、「テキストの△章の内容を発表できるようA ４用紙で４～５枚くらいにまとめたレジュメを作りなさい」といった課題が出ると、多くの新入生が、どうしていいかわからず途方にくれるようです。「字数が埋まらない！」、「書くことが無い！」、「どう書き進めていいかわからない！」と嘆きたくなります。 相当な分量のアカデミック・ライティングをするためには、適切な手順を踏まず、適当に書き出してもうまくいくはずがありません。そのような皆さんのために、どのような手順
Github を使って雑誌原稿を書く - naoyaのはてなダイアリー
今日はこのあと Github の Tokyo Drinkup January 2014 に行くのだが、先方から、もしかしたら 10分ほど Github について話してもらうかも、と打診された。話すか話さないかわからないが、もし話すとしたらと仮定し内容の整理も兼ねて以下「Github を使って雑誌原稿を書く」ということについて書いてみようと思う。 「Github を使って雑誌原稿を書く」もしくは「Github を使った雑誌編集者とのコラボレーション」について、である。 Web+DB PRESS の連載 ご存知の方もいるかもしれないが、このところ技術評論社の Web+DB PRESS で連載をしている。連載を始めて、もう一年近く経った。以前にも Perl に関する連載をしていて、そのときも数年ぐらい続けたので、間があきつつも、なんだかんだでそれぐらいの付き合いになる。 最近は特にテーマは決めず
「原稿を書いては消ししている」という状況を解決するには - 西尾泰和のはてなダイアリー
「原稿を書いては消し書いては消ししていて全然進まない」という話をよく聞きます。 これって「よくない精神状態」にハマり込んでいると思います。 考えてみましょう。人間が脳内で保持できる情報はどれくらいでしょう？原稿に文章Aを書いて、しっくりこないので消して、文章Bを書いた後で、文章Aのことをどれくらい覚えていますか？文章Aを書いている時に何を伝えることが重要だと考えていたか覚えていますか？ 「書いて消して」を繰り返している間、時間は消費されていますが、何も蓄積されていません。何も蓄積されないのであれば、問題はやさしくなったりはしません。ずっと同じ難易度のまま、あなたの前に立ちふさがり続けます。 原稿と戦っているうちに視野が狭くなって、自分が「よくない精神状態」にハマり込んでしまっていることを自覚できなくなるのは怖いことです。さらにはTwitterで愚痴ったり、ネットサーフィンをしてこんなサイト
第19回 「赤ペンでの添削」は逆効果
「若手の日本語力が足りない」「若手の文章力が低い。どうすればいいのか」---。こんな相談を受ける機会が増えています。若手の文章を何度読んでも意味がわからない、ポイントが不明確で冗長な文章が多い、というのです。 新入社員研修で、新人が日報や週報を書く様子を観察していると、「何を書くか考える」というステップを省略していることがわかります。たいていの人がいきなりペンを動かし始めたり、キーボードをたたき始めたりします。頭に思いついたまま書きつづるので、どうしても冗長になったり、散文的になったりするのでしょう。 研修の場に限らず、ふだんの職場でも似たようなことが起こっているのではないでしょうか。 「読み手」と「目的」を意識させる 若手の日本語力・文章力を高めるには、どうすればよいでしょうか。上司や先輩はまず、「読み手」と「目的」を意識させる必要があります。 その際はポイントを伝えるのではなく、若手に
無料でここまでできる→日本語を書くのに役立つサイト２０選まとめ
（例文／コーパス） ◯KOTONOHA「現代日本語書き言葉均衡コーパス」 少納言 www.kotonoha.gr.jp/shonagon/search_form 現代の日本語の書き言葉の全体像を把握できるように集められた約１億語収録の『現代日本語書き言葉均衡コーパス』をジャンルを指定したり、前後にくる言葉を指定した上で検索できる。用例を探したいときはまずここを当たる。 ◯コーパス検索ツールNINJAL-LWP for BCCWJ (NLB) nlb.ninjal.ac.jp/ 『現代日本語書き言葉均衡コーパス』を検索するために、国語研とLago言語研究所が共同開発したオンライン検索システム。上の少納言との違いは、名詞や動詞などの内容語の共起関係や文法的振る舞いを網羅的に表示できるところ。 たとえば「タバコ」を検索すると、用例が「タバコ＋助詞＋動詞」や「動詞＋タバコ」＋「タバコ＋助詞＋形容詞
技術的な文章を書くための第0歩 ～読者に伝わる書き方～ - Qiita
はじめまして。ひつじです。 TechBoosterというウェブサイトでAndroidなどの記事をかいてます。Qiitaには初めて投稿します。 vvakameさんの技術的な文章を書くための1歩、2歩、3歩 を見る人の補助的な気持ちで0歩目を紹介します。 記事の構成方法については、vvakameさんの記事で触れられてることもあり、あまり触れません。 読みやすい文章のための心得をまとめました。 0歩というぐらいなので普段から気を付けている（そして完璧には、こなせていない）内容をまとめています。ただ内容については私自身が気を付けていることですので、もっと皆さんにあった良い方法があるかもしれません。参考になれば幸いです。 文章を書くのに大切なことって？ 言いたいことを1つに絞る １つの文章にたくさんの主張を入れると読む人は混乱してしまいます。ですので、なるべく1つのコンテキスト（章、節、項で主張の大
大学図書館でレポートの書き方を教えるというのはどこから出てくる話なのか？ - 発声練習
はじめにお詫び申し上げます。図書館関連の方々ごめんなさい。たぶん、不快なエントリーです。 ずっと疑問でした。大学図書館でレポートの書き方を教えるという話は何の専門性から登場する話なのでしょうか？ 「内容の指摘よりも、書式や日本語文法、用語の使い方、誤字・脱字の指摘の数の方が多い」．図書館登場せず． （はてなブックマーク - なぜ大学教員の端くれたる私はレポートを返さないのか - 発声練習より） 大学教員は分野問わず、基本的に論文書いたり、本書いたりするのが主業務としてあります。このため、レポートの書き方を教える資質の妥当性は「論文執筆および本執筆の経験者」という点から発生すると思います。一方で、大学図書館の司書の方々がレポートの書き方を教える資質の妥当性は何に由来するのでしょう？ ja.wikipedia: 司書講習の中身をみると、文書作成技術について教えるような科目はないです（もちろん、
修士論文や夏の学校の集録や学振申請書を書く皆さんへ (書き方、注意点、心得) - 宇宙線実験の覚え書き
適宜更新します。 目次 0 はじめに 1 図に関すること 2 日本語全般 3 引用 4 概要 (abstract) 5 添削や指導の依頼の仕方 理科系の作文技術 (中公新書 (624)) 作者:木下 是雄発売日: 1981/09/25メディア: 新書レポートの組み立て方 (ちくま学芸文庫) 作者:是雄, 木下発売日: 1994/02/01メディア: 文庫 0 はじめに 0.1 この記事の目的 2012 年度末に修士論文の添削を初めて真面目に担当し、論文全体についての助言をする以前の段階で、注意すべき点、して欲しい点が多々あることが分かりました。修士論文に限らず、これは学振の申請書、夏の学校の集録原稿、物理学会の講演概要など、修士学生が他の場面で日本語を書く場面でも同じことが言えます。毎回、毎年、同じことを注意するのは面倒ですし、「修士論文 書き方」などで検索して辿りつく人もいるでしょうから
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ナンプラーで南国風に なすのそうめん | 大手小町
小学生向けの教材に読書感想文のテンプレが存在する…賛否分かれるTL
研究者のための英文校正比較