こんにちは、Developer Contentチームのmochikoです。LINE株式会社でテクニカルライターとして働いています。今日は「テクニカルライター」というお仕事と、LINEにあるテクニカルライティングの専門チームについてお話しします。 テクニカルライターという職種があります テクニカルライターって何をしてるの？何を書くの？ ドキュメントはどうやって書いてるの？ どんなメンバーで仕事をしてるの？ ドキュメントを書く以外にこんなこともしているよ でもドキュメントを書くだけだと技術力が下がらない？ どんな人がテクニカルライターに向いてるの？ テクニカルライターという職種があります 私はもともとウェブ制作会社のインフラエンジニアでした。とある技術書を書いたことをきっかけに「テクニカルライターとして一緒に働きませんか？」と声をかけてもらい、LINEへ転職するに至ったのですが、実はお誘いをい

文章の校正チェックを自動で行うVisual Studio Codeの拡張機能「テキスト校正くん」を弊社からリリースしました。無料で利用できます。 テキスト校正くん – Visual Studio Marketplace 短い文章であれば目視でもチェックできますが、長文になるとチェックに時間がかかり見落としも多くなってしまいます。また、いくら内容のいい文章を書いても誤字や脱字が多く体裁が整っていないと、印象が悪く読みづらい文章になってしまいます。 そんなとき、「テキスト校正くん」を利用することで、文章チェックの手間を軽減でき、文章の品質を高めることができます。 ▲VS Codeの拡張機能「テキスト校正くん」 「テキスト校正くん」でできること この拡張機能は、VS CodeでテキストファイルやMarkdownファイル等の日本語の文章をチェックします。編集時に自動で校正のチェックを行い、エディタ

読みやすくわかりやすい文章や、人を傷つけない文章を書くためには、多くの人のチェックが必要です。 文賢（ブンケン）は、独自に研究を続けた「100を超える視点」を用いて、あなたの文章をチェックします。 そして、より良い文章を書くための改善点を提案します。 文賢は、人の気持ちに寄り添う、新しい文章作成アドバイスツールです。

どもです、水野です。 社内にライターさんを抱えてから、１年と数ヶ月が経ち、社内ライターさん向けのライティングマニュアルが出来上がってきたので公開します。 また、2015年の6月頃に下記の外注ライターさん向けライティングマニュアルを公開しているので見比べてもらうと外注・内勤の違いが見えて面白いかもしれません。 社内向けマニュアルは2015年の春頃に作り始めましたが、100回以上のバージョンアップをしています。そして下記マニュアルを元にライター初心者の方が 看護師転職ほっとの記事を書きました。 ※社内向けマニュアルをほぼ100％コピペして貼り付けた形なので、伝わりにくい部分もあるかもしれません＞＜その時には気軽にTwitterでもコメントでも質問してもらえると助かります。 1.(記事作成の大前提1）内容は狭く深く 記事の内容は広く浅くではなく、狭く深く執筆してください。1つの項目に対して深く内

少し前からアウトラインエディタを作ってる。 こんなの (画面は開発中のものです) ファイルツリー 複数シート同時編集 ファイルツリーUIというのをスクラッチで初めて作ってみたんだけど、「当然こう動いて欲しいよな」というヒューリスティックな挙動をたくさん作るハメになってて学びがある。 なぜ作ったか 技術書を書いて Kindle Direct Publishing で販売しようと思って、Macで売れてるアウトラインエディタを一通り試したんだけど、惜しい物が多くて、個人的にしっくり馴染むものがなかった。なので、技術書を書く前に、自分が本を書くために必要なツールを作るところから始めることにした。 作家・藤井太洋に聞く 「小説を書くためのツール、Scrivener」 - DOTPLACE を読んで、その辺のアプリに対する感覚を自分でも意識して作ってる。Scrivener は wysysig なんで自

社内向けの教育資料を、ど素人でもわかるようにと思いながら作っていて、じゃあ「わかりやすい」って何だろうって考えてた。今まで読んできたいろんなわかりやすかった本とそうでない本を思い浮かべながら、一般的にここを注意すればわかりやすさを確保できるだろうっていうポイントを一旦まとめておこうと思った。そうしてまとめてみると、本に限らず人に何かを伝えること一般に適用される話だなと思った。 読む側の負担を減らす わからない＝理解をはばむ障害物がある。この障害物を取り除く／回避する作業が「わかる」ために必要になる。その作業を、作者ではなく読者が負担するとき「わかりにくい」本になる。 日本社会だと情報の受け手の側がこの「わかる」ための作業を負うことでコミュニケーションを成立させる傾向にある。空気を読むというようなことだ。そのため発信者側が事前に手を尽くしてわかりやすく発信するというのが苦手で、相手が汲み取っ

最初に答えを言うと、「良い編集者を持て」になる。 あなたの修論や博論は、どれほどユニークで面白かろうと、そのまま本にはならない。だから、潜在的な読者を見つけ、物理的な本という形に仕上げ、配本・流通に載せて、最終的に買って読んでもらうために、いくつかの準備や手直しが必要となる。その一番の方法が「良い編集者を持て」なのだが、そんなに簡単には見つからない。本書は、こうした「ユニークで面白い論文」と「優れた学術書」の橋渡しをしている編集者が、どういう点に気をつけて、何をアドバイスしているかを、実際の出版事例を用いながら教えてくれる。 最も重要で、かつ全体を貫く勘所は、「誰が読むのか」だと言い切る。ふつうなら「何を書くのか」というテーマが大事ではないかと思うのだが、そのテーマですら、「誰が読むのか」によって揺らぐという。専門性の高い限定された研究対象を論じるのであれば、自ずとそれに興味をもつ読者も限

日本アニメ初の快挙！海外アニメ賞を受賞した『スキップとローファー』海外ライセンス部長&プロデューサーが語る、奮闘の舞台裏

明日は今日より良いものができる— 快適な生活 (@Kaiteki) 2015, 5月 25 全体平日毎日3時間だけ集中して文章書いてる 良い 思っているよりたくさん書ける まとまった重い文章書くのが仕事なのでそこから逃げない制度 1日の体感的な仕事量、10時間くらい研究室いたときと変わんない感じ 1週間単位だと従来より生産性高い、たぶん 3時間だから毎日やれる、毎日5時間は常人には無理、1時間は制度としてバカバカしく無視を選択し、闇が(再)顕現する 具体的中身平日は毎日いつでもいいのでオフィスきて3時間連続して文章書く 文章書くためなら3時間はデータ分析しても書く予定立ててもいい 文章書く以外のことはやらない 音楽は流してもいい 途中でお茶いれるとか無し、先にいれる 3時間の間は手を動かす、文章書いたり直したりデータいじったり手元のメモに何か走り書きしたり、なんでもいいから動きつづける、止

ｃonstexpr関数はコンパイル時処理。これはいい。実行時が霞んで見える。cpuの嬌声が聞こえてきそうだGenya Murakami

WORDで書かれたものは見た目のみならず内容のクオリティも低いことが多い？ WORDを使う意義はあるのか？ てふてふ　てふてふ なのはにとまれ♪

同じ行の修飾語と名詞は、常識的につながるペアとなっている。 １つずつずらして／ランダムに組み合わせた結果を検討していこう。例えば、 ・呼びかける　こだま　→　あたりまえ ・呼びかける　患者　→　ちょっとホラー系 ・呼びかける　ゴミ　→　「ちょっと、おじさん。あたしを捨てたわね！」 筒井康隆のはではでしい失敗のせいか、大抵の小説指南書には「擬人化はやめとけ」とあるが、絶滅危惧種のショートショートの中では顕在である。 地雷臭がぷんぷんするが、ショートショートだから駄作に終わっても次のを書けばよい。 少しでも書けそうな奇想が見つかれば、とにかく書けというから、手順を進めるために先へ進もう。 Step2　因果展開で奇想を世界観に ひとつの出来事であれ行動であれ、それが蔵している可能性を展開していくのには、手塚治虫がやってたプロットの筋トレ 読書猿Classic: between / beyond

ベストセラーにもなった大野晋「日本語練習帳」の中で、著者の大野も一押しのトレーニング法が、この〈縮約〉である。 学生から「あの縮約の授業が一番役に立った」と言われたものでもある。 文章がよく読めるようになりたい、達意の文章が書けるようになりたいと思う人にはきっと役立つだろう。 「日本語練習帳」では、1400字程度の社説を400字に縮約する課題があげられている。 具体例は後ほど見るとして、まずは６つのルールを示そう。 （以下、引用。＝＞以下はこのブログの中の人のコメント） １．縮約とは、要約することや要点を取ることではなく、地図で縮尺というように、文章全体を縮尺して、まとめること。 ＝＞要約ではないので言い換え（パラフレーズ）はしない。出てきた言葉を、その順番通り、その言葉通りに使用する。 ２．1行20字詰20行の原稿用紙を使い、最後の1行あるいは2行の空白を作ってもいけない。つまり、ぴった

あなたは、何かを書いたことがありますか。 そして、ネタ切れになったことは、ありますか。 今夜は「ネタ切れ」について話します。 こんばんは。ゆうきゆうです。 今夜もセクシー心理学から、こんな話をお届けします。 ◆　ヴィヨンの妻の言葉。 あなたは、「ヴィヨンの妻」という小説をご存じでしょうか。 かの太宰治が書いた話で、つい最近、映画化もされたんですが。 ひと言で言うと、「とっても苦労した奥さんの話」です。 本当にひと言ですみません。 で、彼女がものすごく大変な目（映画ではちょっとソフト描写にはなっているんですが）にあって、そのラストで、夫にたいして、こう言うのです。 「私たちは、生きていさえすればいいのよ。」 色々と苦労した妻が言うからこそ伝わる、重みがあるセリフです。 ………。 まぁ、この本を書いた一年後に、太宰治は自殺しちゃうんですけども。 生きていさえしないんですけども。 とはいえ、だか

1回の充電で東京―大阪間に相当する500キロメートルを走れるリチウムイオン電池技術の開発が活発だ。積水化学工業の技術は突破のメドがたち、旭化成も近づいた。いずれも既存の電極を使うこ…続き 再エネ効率的に貯蔵、「ナトリウムイオン電池」寿命・容量が増大 ［有料会員限定］ トヨタの全固体電池　2025～30年ＥＶが化ける ［有料会員限定］

新しい言論プラットフォームとして立ち上がって日も浅い「アゴラbeta」で、池田信夫先生が非常に興味深い議論をしています。 「中間小説」の必要性 - 池田信夫 簡単に言ってしまうと、学問的に正しいことを言うことと、ポピュラリティを得て政策などに反映されることは別だということです。 藤原正彦氏のような議論は、学問の世界では問題になりませんが、彼の本がベストセラーになったことでもわかるように、床屋政談では主流派です。政治の世界でも「市場原理主義」を批判する通俗的な議論が与野党を問わず多く、経済学者の意見はほとんど影響力がない。　これを、政治家や大多数の国民が「無知」であると片づけて終わりにするることももちろんできますし、いわゆる象牙の塔の住民はそうして生きてきているのだと思います。 しかし、さすが池田先生の偉いところは「この責任は、経済学者にもあると思います」と、あっさり認めていることです。そし

はてなブログのヘルプです