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

「いやー、ブログ書きたいとは思ってるんですけど、(良い)ネタが無いんですよねぇ...」 ブログの執筆について最近調子どうですか？と聞くと、時々このような返答が返ってくる事があります。 個人的には、ネタのストック数については時期に拠って変動はあるもの、「ネタが無くて困った...」ということはここまで(クラスメソッドにジョインして、Developers.IO上でブログを書き始めてからは)一度もありませんでした。色々話を聞いていくうちに、所謂「ブログネタの作り方や考え方について慣れていない」ケースが割とあったりするのかな、と思うようになりました。 そこで当エントリでは、私が個人的に「ブログネタをどういう風にして考えたり・作ったりしているのか」についてまとめてみた内容を紹介したいと思います。 目次 基本的には「絶えずネタが無いか」を考えている 「ブログネタリスト」を作成＆メンテナンスしていく 「ブ

This is why you shouldn't interrupt a programmer (なぜプログラマの作業に割り込むべきではないか) という4コマ漫画が話題になっていた。これは別にプログラマではなくても「わかるわかる」という感じの話。 コメントを見ると、だから作業を中断してもすぐ再開できるように自分の考えることをなるべく書き出すようにしているという人が結構多かった。なるほど。 今日は雨が降ったせいで予定が一つキャンセルになったことだし、ちょうどいい機会なので、文章で何かを書くということについて自分が思っていることを書いてみようとおもう。以前 Software Design のドキュメントの書き方特集みたいな号に似たような趣旨の話を寄稿したのだけど、「書く」というのは単に物事を忘れないようにするための行為に留まるものではなくて、自分の考えを整理するための道具なのだ、ということが

タイトル通りだ。お前は自分の好きなものを長々と褒めちぎるテキストを書くべきだ。人に勧めることを意識すると更に良い。レビューなんかでも良い。人生ベストのリストみたいな形態でもOKだ。とにかく、「俺はコレが好きで、こういうところが最高で、これをお前らに知ってほしい！」というのを書いていくべきだ。 僕たちは地獄のような時代を生きている。何かを茶化すだけの低俗なミームが蔓延り、焼き直しのような非生産的なネタがいつまでも受け、煽り記事はいつまでも消えず、パラノイア野郎はどこにだって湧いてくる。 僕はもう飽き飽きしてしまった。インターネットの使われ方自体が変わっていってるのはわかっているが、それにしても今の状況は酷すぎる。ずっと前から酷いが、年々ヤバくなっている。ウンザリだ。 だからせめて自分だけでも、と思い、このnoteで萌え語りを始めたのが最近のことなのだが、これが思った以上に楽しい。オマケに記事

おすすめなカンファレンス用プロポーザルの書き方 こんにちは、builderscon 主宰の牧です！今回は builderscon tokyo 2017の一般セッション公募開始に合わせて、「カンファレンス用プロポーザルの書き方」について、私なりの知見を共有させていただきたいと思います。 builderscon.io 技術カンファレンスに登壇したい！そう思ってプロポーザルを応募したものの、採用されずにガッカリしてしまう… そんな経験をしたことがある技術者の方は多いと思います。 私はこれまで自身でも様々なプロポーザルを応募してきましたが、さらに審査側として膨大な数のプロポーザルの取捨選択をしてきました。カンファレンス主催者としてはなるたけ多くのおもしろいプロポーザルを採用したいと考えており、審査時には長い時間をかけ、悩みながらプロポーザルを吟味しています。 ですが、審査をしていると実はかなりの数

ちょっとしたことでも雑にブログに書いておくと良いことが起こる - $shibayu36->blog; で、ちょっとしたことでも雑にブログに書いておくと良いことが起こるよということを書いた。さらに余談として最低限の雑さについても書いた。 これをきっかけに、公開の場でアウトプットする時の最低限の雑さとはなんだろうという疑問が自分に生まれ、雑さによる問題や、それを引き起こさないようにするための自分の工夫について少し頭がまとまってきたので、自分の考えを書いておく。 過度な雑さから生じる最大の問題 まずあまりにも雑に公開の場に書いてしまった場合の最大の問題について考える。この時、一番起こってほしくない問題は、「読み手が誤った情報を正しい情報と信じてしまう」ことだと考えた。 あまりにも雑な文章は読み手の誤認を引き起こし、正しい情報ではないのに正しいと読み手が解釈してしまう問題がある。正しいと解釈してシ

新年一発目のブログは腰が重いがゆえに、いざ書き出すと長くなる悪い癖──ですが、今年も継続アウトプット頑張っていきます。よろしくお願いします！ ──昨年9月に、書籍『たのしいインフラの歩き方』を発売させていただきましたが、数ヶ月が経って年も変わったので、執筆話の発生からどのような経緯があったのかなどについて、まとめてみます。一冊しか書いていないのでアレかもですが、私のように職業ライターではない、本職がエンジニアの方の初執筆や、会社内における調整などの参考にしていただければと思います。 目次 執筆話の発生 会社との調整 執筆契約と〆切 著作権 印税 執筆作業 編集 告知 発売後 執筆について 執筆話の発生 初動 ブログに設置してある、問い合わせフォームからメールがきました。技術評論社の編集者と名乗る方から、ITインフラについての書籍を執筆してみませんか、という内容です。 メールの『執筆』という

「文章を書くのは苦手」という人に向けて、10年以上の編集作業で蓄積してきたノウハウを紹介し、「こうすると、もっと分かりやすい記事が書けるかも」という提案を行う。 ← 前回 連載 INDEX 「文章を書くのが苦手なので……」 編集者をしていると、このように言われてメディア向けに記事や本を書くのをためらわれ、結果的に書いてもらえないということがよくある。その方は素晴らしい情報や技術を持っているのに、それを文章として記録し、より多くの人に伝えられないのは、いろいろな意味で大きな機会損失だ。 確かに、勉強会やカンファレンスなどのイベントに登壇して発表するなど、他にも情報を公表する手段はある。でも、何千人、何万人という人の前で登壇する機会はまれであるし、記録映像やスライドが視聴・閲覧できるとしても、やはりその視聴数は、本やWeb記事の購読者数にはなかなか及ばないだろう。しかも文章にしておけば、再確認

書評をブログで書く人に憧れる 本の要約や感想をブログに書いている人はスゴいなーと思います。 本を読みながら、どの部分が一番重要なのか・どこを引用するのか・読んでいる最中に何を感じたのか…書評を書くために様々なことを考えながら本を読んでいるんだと思います。そして、自分の意見を入れて本を総評する。 書く側の受け取り方によっては、批判を受けることもありそうだし、自分の意見がしっかり語れない人にはできないブログ記事かと。自分語りが多すぎるの書評はなんか違うと思うけど。 私が書評ブログを参考にするとき 私が書評ブログを参考にするのは、まだ未読の本で購入を迷ったとき、それは本当に自分が求めている本なのか購入前の内容確認。それと、読んだあとに自分の捉え方以外の他人の意見を知りたい時。なにか本が読みたいけど、次はどれにしようというタイミングでも見ることがあります。 こう書いてみると私は、購入の後押しをして

サービスを運営していると、最適な文章を書く事も多いです。分かりやすい文章を書く事でユーザーに対する理解が深まり、結果的にグロースに繋がります。 今回は、この記事だけを読んでおけば必ず文章力が向上する記事をまとめました。 文章力がどんどん向上する５つの書き方・トレーニング方法 ライティング力が向上する書き方と、文章力を向上させるためのトレーニング方法が書かれた記事。 第2回：わかりやすい文章の10大原則 理解される文章の10個の原則について書かれている記事。 文章のプロ直伝！素人でもプロ並に書けるようになる５つのテクニック プロのように書くための5つのテクニックについて解説されている記事。 有名小説家が伝授する、ショートストーリーを書くための8つの法則 文章を書くプロである小説家の文章を書くコツがまとめられている記事。 読みやすい文章を書くための技法 読んだ人が、しっかりと理解をしてもらう

100記事以上書いてきたので公開してみる。 去年からブログで本を紹介してきたが、いつの間にかその数が百を越えていた。ずいぶん前に「あと百冊書いたらノウハウを公開しようかな」*1と言っていたので、今日は書評の書き方を教えようと思う。 書評に必要な態度 友人にその本を紹介するように書くこと。よく見かけるのが引用文やあらすじをだらだらと書き写して最後に自分の考えを一言二言添えるだけ、というスタイル。友人にむかってあなたは同じことを行うだろうか。 「この本やばいよ」 「え？どこが」 「だから〜、ぺらぺらぺらぺら……」 十分後 「っていうわけなんだよー」 これでは本の面白さが伝わるわけがない。友人に紹介するなら、あらすじと気に入ったフレーズと述べるに留まる方が良い。「それだけでいいの？」と思うかもしれないが、それだけでいい。 ただ、もう少し付け足したいと思う時は次の要素を加えるといい。 書評を書くと

FINDJOB! 終了のお知らせ 2023年9月29日にFINDJOB!を終了いたしました。 これまでFINDJOB!をご利用いただいた企業様、求職者様、様々なご関係者様。 大変長らくFINDJOB!をご愛顧いただき、誠にありがとうございました。 IT/Web系の仕事や求人がまだ広く普及していない頃にFind Job!をリリースしてから 約26年間、多くの方々に支えていただき、運営を続けてまいりました。 転職成功のお声、採用成功のお声など、嬉しい言葉もたくさんいただきました。 またFINDJOB!経由で入社された方が人事担当になり、 FINDJOB!を通じて、新たな人材に出会うことができたなど、 たくさんのご縁をつくることができたのではないかと思っております。 2023年9月29日をもって、FINDJOB!はその歴史の幕を下ろすこととなりましたが、 今後も、IT/Web業界やクリエイティブ

忙しい人のための要約 以下の５つのパートで文章を構成する。 Ａ．〈はじめ〉　……内容の紹介・要約 Ｂ１．〈なか１〉　……具体例その１ Ｂ２．〈なか２〉　……具体例その２ Ｃ．〈まとめ〉　……具体例の共通点 Ｄ．〈むすび〉　……上記の共通点の一般化〈としての主張〉 書く順序は次の通り。 １．具体例をあつめる→〈なか１〉〈なか２〉 ２．具体例の共通点を書く→〈まとめ〉 ３．まとめから言えること（主張〉を書く→〈むすび〉 ４．内容を簡単に紹介する入口を書く→〈はじめ〉 （ほかに参考になりそうな記事） ・文章の型稽古→穴埋めすれば誰でも書ける魔法の文章テンプレート 読書猿Classic: between / beyond readers ・物事を論じられるようになるスモール・ステップス→米国の小学生が使う思考ツール 読書猿Classic: between / beyond readers 書くこと

本を書いてからこっち、年度末で忙しかったり、体調がずっと悪かったりしていますが、そろそろ本気出します。正誤表も大幅にアップデートします。今書いてる。 今日は、本を書いてみてどうだったか、ということをふり返る。たぶんこれで本について触れるのは最後かな。宣伝はたまにすると思いますが。 ※思いがけず大量にアクセスがあったから、最後に追記を書いたので、そっちも読んでね！ 本を書いたきっかけ 会社の方でPFIセミナーという勉強会のようなものをやっており、なぜかそれがUStreamでインターネットに中継されているのだが、そこで日本語入力の話をしたら「本書かない？」って話が来た。編集さんとは、その前年に会社に来たWEB+DB Pressの記事執筆依頼で記事を書いた際に知り合ったので、そういう意味では貪欲にチャンスを掴みに行った結果であると言えなくもない。 PFIセミナーがUSTで中継されるようになったの

「本を読まなくても読書感想文が書ける」みたいな話は（「これをコピペしろ」みたいなサイトを含めて）ネット上にいくらも転がっている。 もう少し心ある人に向けて、「ちゃんと本を読んで、いくらかましな感想文が書ける」方法について書く。 なぜ読書感想文は面倒なのか？ ところで読書感想文に零点はない。 提出さえすれば、どれだけめちゃくちゃな日本語で書かれていてもリジェクト（突き返）されることはまずない。 落とされるとすれば、他人が書いたものをコピペ（丸写し）した時ぐらいだ。 なんとなれば、多くの読書感想文出題者は、何が読書感想文であり何がそうでないかを線引きできるような定義も持ち合わせず、したがって明確な採点基準をつくることもできず、せいぜいが大雑把な３段階評価（優・良・可）をつけるぐらいが関の山だからだ。 読書感想文は、未だに多くのところで「自由作文」的な丸投げをされている。 何のサジェスチョンもな

ProBlogger で「あなたのブログに人が何度でも訪問するようにする29の方法」という記事があり、ブロガーとしてなるほどなるほどと、興味深く読んでいました。 しかしこれを逆に自分に当てはめて、自分が繰り返し訪問しているブログに期待していることは何だろうかと考えてみると、やはり自分がブログを書くときに理想としている（そして、なかなかたどり着けない）ことだということに気づきました。ざっと７つほど思いついたので共有したいと思います。 1. 常に一歩先の情報を教えてほしい 一歩先というのは、新しい製品やアプリケーションの情報であってもよいのですが、「クラウドサービスがもたらす未来」といったように、半歩ほど未来をみすえて書かれたものであってもいいと思います。「あ、世界はこっちに動いているのか」という感触を抱かせるブログは毎日のように読んでしまいますね。 2. あなた自身の意見を聞かせてほしい ブ