LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
これでもう”ネタ切れ”には困らない！『ブログネタ』の作り方・考え方10選 | DevelopersIO
「いやー、ブログ書きたいとは思ってるんですけど、(良い)ネタが無いんですよねぇ...」 ブログの執筆について最近調子どうですか？と聞くと、時々このような返答が返ってくる事があります。 個人的には、ネタのストック数については時期に拠って変動はあるもの、「ネタが無くて困った...」ということはここまで(クラスメソッドにジョインして、Developers.IO上でブログを書き始めてからは)一度もありませんでした。色々話を聞いていくうちに、所謂「ブログネタの作り方や考え方について慣れていない」ケースが割とあったりするのかな、と思うようになりました。 そこで当エントリでは、私が個人的に「ブログネタをどういう風にして考えたり・作ったりしているのか」についてまとめてみた内容を紹介したいと思います。 目次 基本的には「絶えずネタが無いか」を考えている 「ブログネタリスト」を作成＆メンテナンスしていく 「ブ
スタートアップの現場で役立つ開発要件のまとめ方
こんにちは。ハウスマートの高松(@t2kmt)です。 皆さんは開発要件をまとめるのにどんなフォーマットを使っていますか？ 開発要件をいい感じにまとめるのって大変ですよね。 ドキュメント整備せずに開発に着手し始めてしまうと手戻り抜け漏れが出てしまいますが、一方で要件定義書をガチガチなフォーマットにするとドキュメントの作成自体の工数が増えてしまいます。 スタートアップはスピードが命。ドキュメントを書きまくって開発が進まないなんて言語道断です。 開発要件の整理はプロジェクトの成否に多大なインパクトを与えますが、ほとんどの現場では企画を考える人にフォーマットが委ねられていることが多いと思います。 今回は皆さんが快適に開発要件をまとめられるように、ハウスマートで利用している mini spec というフォーマットをご紹介します。 mini spec とは mini spec とは開発の要件をまとめる
「書く」のは特別な道具 - naoyaのはてなダイアリー
This is why you shouldn't interrupt a programmer (なぜプログラマの作業に割り込むべきではないか) という4コマ漫画が話題になっていた。これは別にプログラマではなくても「わかるわかる」という感じの話。 コメントを見ると、だから作業を中断してもすぐ再開できるように自分の考えることをなるべく書き出すようにしているという人が結構多かった。なるほど。 今日は雨が降ったせいで予定が一つキャンセルになったことだし、ちょうどいい機会なので、文章で何かを書くということについて自分が思っていることを書いてみようとおもう。以前 Software Design のドキュメントの書き方特集みたいな号に似たような趣旨の話を寄稿したのだけど、「書く」というのは単に物事を忘れないようにするための行為に留まるものではなくて、自分の考えを整理するための道具なのだ、ということが
お前もオタクなら好きなものをべた褒めする長文を書きやがれ｜まきちゃん｜note
タイトル通りだ。お前は自分の好きなものを長々と褒めちぎるテキストを書くべきだ。人に勧めることを意識すると更に良い。レビューなんかでも良い。人生ベストのリストみたいな形態でもOKだ。とにかく、「俺はコレが好きで、こういうところが最高で、これをお前らに知ってほしい！」というのを書いていくべきだ。 僕たちは地獄のような時代を生きている。何かを茶化すだけの低俗なミームが蔓延り、焼き直しのような非生産的なネタがいつまでも受け、煽り記事はいつまでも消えず、パラノイア野郎はどこにだって湧いてくる。 僕はもう飽き飽きしてしまった。インターネットの使われ方自体が変わっていってるのはわかっているが、それにしても今の状況は酷すぎる。ずっと前から酷いが、年々ヤバくなっている。ウンザリだ。 だからせめて自分だけでも、と思い、このnoteで萌え語りを始めたのが最近のことなのだが、これが思った以上に楽しい。オマケに記事
登壇の可能性をあげる！カンファレンスプロポーザルの書き方のススメ - builderscon::blog
おすすめなカンファレンス用プロポーザルの書き方 こんにちは、builderscon 主宰の牧です！今回は builderscon tokyo 2017の一般セッション公募開始に合わせて、「カンファレンス用プロポーザルの書き方」について、私なりの知見を共有させていただきたいと思います。 builderscon.io 技術カンファレンスに登壇したい！そう思ってプロポーザルを応募したものの、採用されずにガッカリしてしまう… そんな経験をしたことがある技術者の方は多いと思います。 私はこれまで自身でも様々なプロポーザルを応募してきましたが、さらに審査側として膨大な数のプロポーザルの取捨選択をしてきました。カンファレンス主催者としてはなるたけ多くのおもしろいプロポーザルを採用したいと考えており、審査時には長い時間をかけ、悩みながらプロポーザルを吟味しています。 ですが、審査をしていると実はかなりの数
雑に書いたブログ記事が問題を起こさないようにする工夫 - $shibayu36->blog;
ちょっとしたことでも雑にブログに書いておくと良いことが起こる - $shibayu36->blog; で、ちょっとしたことでも雑にブログに書いておくと良いことが起こるよということを書いた。さらに余談として最低限の雑さについても書いた。 これをきっかけに、公開の場でアウトプットする時の最低限の雑さとはなんだろうという疑問が自分に生まれ、雑さによる問題や、それを引き起こさないようにするための自分の工夫について少し頭がまとまってきたので、自分の考えを書いておく。 過度な雑さから生じる最大の問題 まずあまりにも雑に公開の場に書いてしまった場合の最大の問題について考える。この時、一番起こってほしくない問題は、「読み手が誤った情報を正しい情報と信じてしまう」ことだと考えた。 あまりにも雑な文章は読み手の誤認を引き起こし、正しい情報ではないのに正しいと読み手が解釈してしまう問題がある。正しいと解釈してシ
21世紀の文字起こし - the code to rock
気づき そもそも文字起こしとは そもそも文字起こしとは（2） 音声入力による文字起こしの実践法（Mac） 1. 素材音声の再録音 2. Soundflowerの準備 3. Mac内部で再生＋聞き取り 4. 音声ファイルが終わるまで再読み込みなどのケア まとめ 〜そしてtextlint編へ〜 続編 気づき 少し前にこのようなことに気がついた。 ひえーすごい発見をした。音声入力で文字起こし作業をナシにできないかなあ、と思って対談の音声データをiPhoneのそばで大音量で再生したけど全然認識せず。ですよねー、と一旦諦めた後にふとイヤホンで聴きながらシャドウイング的に自分で喋ったらだいぶテキスト化された（笑）これはいいのでは— Hiroaki Kadomatsu (@note103) 2016年7月6日 「いずれそうなるだろう」とは思っていたが「まだしばらく先のことだろう」とも思っていた現実が、想
エンジニアが初めて書籍を執筆するにあたって | 外道父の匠
新年一発目のブログは腰が重いがゆえに、いざ書き出すと長くなる悪い癖──ですが、今年も継続アウトプット頑張っていきます。よろしくお願いします！ ──昨年9月に、書籍『たのしいインフラの歩き方』を発売させていただきましたが、数ヶ月が経って年も変わったので、執筆話の発生からどのような経緯があったのかなどについて、まとめてみます。一冊しか書いていないのでアレかもですが、私のように職業ライターではない、本職がエンジニアの方の初執筆や、会社内における調整などの参考にしていただければと思います。 目次 執筆話の発生 会社との調整 執筆契約と〆切 著作権 印税 執筆作業 編集 告知 発売後 執筆について 執筆話の発生 初動 ブログに設置してある、問い合わせフォームからメールがきました。技術評論社の編集者と名乗る方から、ITインフラについての書籍を執筆してみませんか、という内容です。 メールの『執筆』という
分かりやすい記事を書くための原則とテクニック
「文章を書くのは苦手」という人に向けて、10年以上の編集作業で蓄積してきたノウハウを紹介し、「こうすると、もっと分かりやすい記事が書けるかも」という提案を行う。 ← 前回 連載 INDEX 「文章を書くのが苦手なので……」 編集者をしていると、このように言われてメディア向けに記事や本を書くのをためらわれ、結果的に書いてもらえないということがよくある。その方は素晴らしい情報や技術を持っているのに、それを文章として記録し、より多くの人に伝えられないのは、いろいろな意味で大きな機会損失だ。 確かに、勉強会やカンファレンスなどのイベントに登壇して発表するなど、他にも情報を公表する手段はある。でも、何千人、何万人という人の前で登壇する機会はまれであるし、記録映像やスライドが視聴・閲覧できるとしても、やはりその視聴数は、本やWeb記事の購読者数にはなかなか及ばないだろう。しかも文章にしておけば、再確認
読書感想文にも使える、書評ブログ達人たちの書き方 - AIUEO Lab2
書評をブログで書く人に憧れる 本の要約や感想をブログに書いている人はスゴいなーと思います。 本を読みながら、どの部分が一番重要なのか・どこを引用するのか・読んでいる最中に何を感じたのか…書評を書くために様々なことを考えながら本を読んでいるんだと思います。そして、自分の意見を入れて本を総評する。 書く側の受け取り方によっては、批判を受けることもありそうだし、自分の意見がしっかり語れない人にはできないブログ記事かと。自分語りが多すぎるの書評はなんか違うと思うけど。 私が書評ブログを参考にするとき 私が書評ブログを参考にするのは、まだ未読の本で購入を迷ったとき、それは本当に自分が求めている本なのか購入前の内容確認。それと、読んだあとに自分の捉え方以外の他人の意見を知りたい時。なにか本が読みたいけど、次はどれにしようというタイミングでも見ることがあります。 こう書いてみると私は、購入の後押しをして
読むだけで学べる！文章力が劇的に向上する超良質記事まとめ10選。 | SIROKグロースハックブログ
サービスを運営していると、最適な文章を書く事も多いです。分かりやすい文章を書く事でユーザーに対する理解が深まり、結果的にグロースに繋がります。 今回は、この記事だけを読んでおけば必ず文章力が向上する記事をまとめました。 文章力がどんどん向上する５つの書き方・トレーニング方法 ライティング力が向上する書き方と、文章力を向上させるためのトレーニング方法が書かれた記事。 第2回：わかりやすい文章の10大原則 理解される文章の10個の原則について書かれている記事。 文章のプロ直伝！素人でもプロ並に書けるようになる５つのテクニック プロのように書くための5つのテクニックについて解説されている記事。 有名小説家が伝授する、ショートストーリーを書くための8つの法則 文章を書くプロである小説家の文章を書くコツがまとめられている記事。 読みやすい文章を書くための技法 読んだ人が、しっかりと理解をしてもらう
書評、読書感想文の書き方 - マトリョーシカ的日常
100記事以上書いてきたので公開してみる。 去年からブログで本を紹介してきたが、いつの間にかその数が百を越えていた。ずいぶん前に「あと百冊書いたらノウハウを公開しようかな」*1と言っていたので、今日は書評の書き方を教えようと思う。 書評に必要な態度 友人にその本を紹介するように書くこと。よく見かけるのが引用文やあらすじをだらだらと書き写して最後に自分の考えを一言二言添えるだけ、というスタイル。友人にむかってあなたは同じことを行うだろうか。 「この本やばいよ」 「え？どこが」 「だから〜、ぺらぺらぺらぺら……」 十分後 「っていうわけなんだよー」 これでは本の面白さが伝わるわけがない。友人に紹介するなら、あらすじと気に入ったフレーズと述べるに留まる方が良い。「それだけでいいの？」と思うかもしれないが、それだけでいい。 ただ、もう少し付け足したいと思う時は次の要素を加えるといい。 書評を書くと
FINDJOB!終了のお知らせ | FINDJOB!
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で中継されるようになったの
こうすれば読書感想文が書ける／今すぐ使える穴埋めシートと構成パターン
「本を読まなくても読書感想文が書ける」みたいな話は（「これをコピペしろ」みたいなサイトを含めて）ネット上にいくらも転がっている。 もう少し心ある人に向けて、「ちゃんと本を読んで、いくらかましな感想文が書ける」方法について書く。 なぜ読書感想文は面倒なのか？ ところで読書感想文に零点はない。 提出さえすれば、どれだけめちゃくちゃな日本語で書かれていてもリジェクト（突き返）されることはまずない。 落とされるとすれば、他人が書いたものをコピペ（丸写し）した時ぐらいだ。 なんとなれば、多くの読書感想文出題者は、何が読書感想文であり何がそうでないかを線引きできるような定義も持ち合わせず、したがって明確な採点基準をつくることもできず、せいぜいが大雑把な３段階評価（優・良・可）をつけるぐらいが関の山だからだ。 読書感想文は、未だに多くのところで「自由作文」的な丸投げをされている。 何のサジェスチョンもな
「シンプルな文章の書き方」 ― 読まれなかった文章をカイゼンしてわかったこと : earth in us.
このドメインは お名前.com から取得されました。 お名前.com は GMOインターネットグループ(株) が運営する国内シェアNo.1のドメイン登録サービスです。 ※表示価格は、全て税込です。 ※サービス品質維持のため、一時的に対象となる料金へ一定割合の「サービス維持調整費」を加算させていただきます。
なんどでも繰り返し訪問するブログに期待する７つのこと
ProBlogger で「あなたのブログに人が何度でも訪問するようにする29の方法」という記事があり、ブロガーとしてなるほどなるほどと、興味深く読んでいました。 しかしこれを逆に自分に当てはめて、自分が繰り返し訪問しているブログに期待していることは何だろうかと考えてみると、やはり自分がブログを書くときに理想としている（そして、なかなかたどり着けない）ことだということに気づきました。ざっと７つほど思いついたので共有したいと思います。 1. 常に一歩先の情報を教えてほしい 一歩先というのは、新しい製品やアプリケーションの情報であってもよいのですが、「クラウドサービスがもたらす未来」といったように、半歩ほど未来をみすえて書かれたものであってもいいと思います。「あ、世界はこっちに動いているのか」という感触を抱かせるブログは毎日のように読んでしまいますね。 2. あなた自身の意見を聞かせてほしい ブ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
日本語文章校正ツール - フリーで使える表現チェック・文字校正支援Webツール