執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら
中村明博（編集者） @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、！ 2021-03-05 12:14:24 中村明博（編集者） @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 2021-03-05 14:37:22 中村明博（編集者） @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人
ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ - Qiita
システム開発にドキュメントは欠かせません。ドキュメントが得意になれば活躍の幅が大いに広がりますよね。 この記事では、まず冒頭でドキュメントの作成に求められると思うことを整理した上で、そのスキル獲得に役立つと思われる記事や書籍を集めてみました。もちろん他にもあると思うので、もしお薦めのものがあれば是非コメントで教えて下さい 更新履歴 ・2021/04/16：文章術系にリンクを追加しました。 ・2020/11/28：文章術系にリンクを追加しました。 ・2020/07/24：文章術系にリンクを追加しました。 ・2020/05/24：文章術系にリンクを追加しました。 ・2020/05/14：スライドデザイン系にリンクを追加しました。 ・2020/04/29：スライドデザイン系にリンクを追加しました。 ・2020/04/17：文章術系にリンクを追加しました。 ・2020/04/12：関連するTwit
LINE社内テクニカルライティング講座第3弾！不要な人に社内文書を読ませないコツ
こんにちは。Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。LINE社内で大評判のテクニカルライティング講座をブログにまとめてみたシリーズも第3弾になりました。（第1弾、第2弾もぜひ読んでください！） 今回の記事では、以下のようにトピックが多く集まったときに「自分が書いたトピックを（その情報が不要な人に）読ませないためのコツ」を説明します。具体的には、順番に気を配ったり、情報の分類を気をつけたり、タイトルを工夫したり、という話をします。 全部読んでもらおうとしていませんか？ おそらくほとんどの人は、ほかの人の文章を読むときに、必要そうな文だけピックアップして読んだり、タイトルだけで内容を判断したつもりになったりすると思います。検索エンジンで検索したときに、表示された内容だけで、文章の内容を推測して読むか読まないか決めますよね。そう
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介しています。 どれくらい大評判だったかというと、2日間4セッションでしたが、エントリー数はのべ1000人を超え、実際の参加人数はのべ約900人。アンケートの回答は以下のとおり
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
『Readyyy!』でのLive2D活用事例 - SEGA TECH Blog
2019年6月末でサービスを終了した『Readyyy!』。その『Readyyy!』にテクニカルアーティストとして参加していましたセガゲームスの宮下です。『Readyyy!』をプレイしてくださった皆様、本当にありがとうございました。 また、社内はもちろん、大勢の社外の方々のお力添えでリリースした『Readyyy!』でしたが、アプリのサービスを早々に終了させる結果になってしまったこと、誠に申し訳ありませんでした。スタッフ一同一丸となって取り組みましたが、力及びませんでした。 そんな中『Readyyy!』をプレイしていただき、サービス終了を惜しんでくださる皆様からは、厳しいご意見をはじめ、心温まるお手紙、想いの詰まった色紙などをいただきました。皆様のお声は開発チームまでちゃんと届いており、スタッフ一同ありがたく読ませていただいております。そして、そのような𠮟咤激励のお声にどう応えていくのか、日
「簡単な話から始めよう！」～ソフトウェア開発者に贈るテクニカルライティングの極意
はじめに テクニカルライティングでは、なんらかの技術を解説することが多いものです。そのとき、いっぺんに全てを説明しようとしていませんか？ それをやってしまうと、一度に大量の情報を受け取った読み手は消化不良をおこしてしまいます。情報の奔流に溺れてしまうでしょう。最初は想定している読者にすっと受け取ってもらえるサイズの情報量から始めて、それからだんだんと情報を増やしていくような書き方をするとよいです。 そういうちょっとずつ情報を増やしていく解説のやり方の1つとして、今回は簡単な話から初めてステップアップしていくというパターンを紹介しましょう。 いっぺんに全てを語るな！ 簡単な話から難しい話へステップアップ 対象読者 テクニカルな文章を書いている人／書かなきゃならなくなった人 その中でも、とくにソフトウェア開発に関わっている人 テクニカルライティングの領域は広いですけど、この連載ではソフトウェア
説得力のある文章に必要な条件とは何か。 | Books&Apps
コンサルタントをしていた、ということもあり、15年以上にわたり、私にはずっと「文章のレビュー」を引き受ける仕事がついて回っている。 もちろん今も、1日に数本程度は誰かの書いた文章に赤入れをしている。 手間がかかり、非常に時間もかかる仕事だ。 とはいえ、実はこれはなかなかおもしろい仕事だ。 というのも、文章は話し言葉以上に「書き手の頭の中」が非常によく分かるので、ある種、人間観察のような側面があるのだ。 人間そのものに興味がある私にとっては、趣味と実益を兼ねたおいしい仕事と言えよう。 さて、そうして何百、何千という文章をレビューするうちに、ある日私は一つの疑問を持った。 それは「文章の説得力」についてである。 同じことを訴えているはずなのに、ある人の文章にはとても説得力がある一方で、別の人の文章はとても胡散臭い。 文章の説得力は、一体何が決めているのだろうか？ 「説得力はエビデンスとロジック
最近はこんな書き方で書いているーフレームド・ノンストップ・ライティング
時間がない人のための要約 １．フォーマットを細分化して、〈ここでは何を書くべきか〉を示すフレームを作っていく ２．フレームごとに、このトピックについて書けることを、順不同／思いつくだけ止まらずに書く（フレーム内で殴り書き） ３．２のなぐり書きを読み返し重要そうなところに下線を引き、下線部を一文にまとめる。 ４．殴り書きできない（足りない）フレームについては、要調査、要発想のタグをつけておいて、まとめて処理する （クリックで拡大） 〈書きべきこと〉と〈書けること〉 文章を書くには、正反対の方法が二つある。 一つは書くべきこと（NTW: need to write）を先に定めるアプローチである。 何を書くべきかを細部に至るまで決めることができれば、究極には、文章を書くことは穴埋め作業に還元される。 そこまでいくのは現実的には無理でも、多くの文章には、どんな順序で何を書けばいいかを示す大まかなフ
良い記事を書くためのガイドライン | Qiita ヘルプ
良い記事を書くためのガイドラインこのガイドラインについて Qiitaは、プログラミングに関する知識を記録・共有するためのサービスです。Qiita上の記事は、投稿者以外の人にとっても価値のある記事であることが望まれます。 あなたの知識が他の誰かの役に立つようにするために、このガイドラインを参考にしてください。 役に立つ記事を書くために Qiitaに投稿した記事はフィードに表示され、他のユーザーが目にすることになります。また検索から記事を見つける人もいるでしょう。あなたの記事が読んだ人の役に立つかどうかを意識してみましょう。 自分用のメモのつもりで書いたものでも、少し気をつけるだけでぐっと価値のある記事にすることができます。 意識すると望ましいもの 具体的で簡潔なタイトルをつける 記事のタイトルは、記事のページだけでなくQiitaのフィードや検索エンジンの検索結果にも表示されます。タイトルを見
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
技術文書を書く際の、心技体