リモート開発を助ける「思いやりのある文章」の書き方 - ROUTE06 Tech Blog
新しいプロジェクトに参加してローカル環境を作り始めると、何かとエラーに遭遇します。 また、設計や実装について開発者に相談したり、コードレビューを依頼することもありますね。 開発者が近くにいれば、（それなりに、程よいタイミングを見計らって）話しかけて、エラーの原因を調べてもらったり、設計方法をホワイトボードにスケッチしながら相談できますが、リモート開発ではそうはいきません。 リモート開発で成果を上げるためには、このブログのように何の装飾もインタラクティブ性もない文章で、自分の状況や相談したい事柄を正確に伝える必要があります。 とはいえ私は昔、「文章がわかりにくい」と毎日、毎日上司にフィードバックをもらうくらいには文章を書くのが下手くそでした。今もわかりやすい文章が書けている自信はありません。 それでも、これまでに何度か、議論が好転したり、プロジェクトが前に進むきっかけとなる文章を書けたことが
エンジニアのための、いますぐ使える文章校正テクニック - ICS MEDIA
ウェブ制作や開発の仕事で文章を扱う機会は多いはず。書き手は不自然に思っていない文章でも、読み手は違和感をもっていることがあります。文章校正テクニックを覚えるだけでおかしな表現は少なくなり、読みやすい文章を書けるようになります。 本記事では、ICS MEDIAで実践している文章校正の一例を紹介します。 レベル1、基本的な校正ルールを使う いろんな場面で使える基本的な文章校正テクニックから紹介します。 テクノロジー系の名詞は正しく記載しているか テクノロジー系の名詞を間違って使うと、「本当に技術に詳しいの？」と読者からの信頼度が下がります。名詞は大文字小文字、スペース有無含めて正確に記述しましょう。 Github → GitHub（Hは大文字） Javascript → JavaScript（Sは大文字） After Effect → After Effects（複数形の「s」を忘れてはいけな
動画より文章の方が理解しやすい人にとって、動画解説はめちゃくちゃ苦痛なのに、社会全体では動画が推されててキツい - Togetter
George @Love_yellowhat 動画よりも文章の方がはるかに早く理解できるし効率がよいと考えるタイプの人にとって、動画による説明しかないコンテンツはめちゃくちゃ苦痛 2021-09-28 20:20:43
20年以上ネットに文章を書き続けた上で文章術の本をたくさん読んで分かった「文章を書く方法」 - karaage. [からあげ]
文章を書く方法 あくまで、「良い文章を書く方法」でも「文章を書く極意」でもなく「（普通の）文章を（普通に）書く方法」です。 20年以上ネットに文章を書いたりしているうちに、いつのまにか商業誌に数十本寄稿したり、書籍も数冊出したりしていました。あんまり意識していなかったのですが、ひょっとしたら自分はある意味、作家に近いのかもしれません（ご飯は食べてないので、プロ作家ではなく、セミプロかハイアマというところでしょうか）。 「ということは、少しは上手な文章を書けたほうが良いのかな？」と思い、最近いくつか文章術の書籍を読み漁っています。「今さら！？」という声が聞こえてきそうですが、そうです、今さらです。本を出す前に読めよって話ですよね。『鬼滅の刃』なら、鱗滝さんに「判断が遅い」と10回くらい殴られているところです。 遅いながらも、文章術の本は20冊くらい読みました。その上で、自分が思う「文章を書く
![20年以上ネットに文章を書き続けた上で文章術の本をたくさん読んで分かった「文章を書く方法」 - karaage. [からあげ]](https://cdn-ak-scissors.b.st-hatena.com/image/square/ae58184cd6071cb40b5e6785916de7db87ab7e8d/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fk%2Fkaraage%2F20240220%2F20240220111737.png)
テックブログに関わる人に読んで欲しい、「エンジニアの文章をレビューする」技術｜中川 伸一 / Engineer Manager
気がつけば久々のnoteになってしまいましたが、私は元気です。 近況は...最近鍛えながら健康やせしたのでプロフィール写真を撮影し直しました、そのうちnoteに書こうと思います。 それはさておいて、4月に「週刊はてなブログ」さんの企画でこんなインタビューに答えました。 もうすぐ7年目を迎える個人技術ブログ「Lean Baseball」および、所属するJX通信社の「JX通信社エンジニアブログ」の話をメインに、「自分が書きたいことを書くことによって自分のキャリアにもつながるしなんだったら人のキャリアにもいい影響あるんやで」という話をしました（究極に端折るとそういう話です）。 補足で書いた番外編を含め、色々と好反響を頂き嬉しかったですありがとうございます。 一人のエンジニアであり、一人の技術ブロガーである私の物語としてはこれはこれで良いのですが、 テックブログに関わる人達が、エンジニアの気持ちを
伝わる文章作成の基本を学ぶための記事・学習コンテンツのまとめ - Qiita
短いメッセージを書くことはできても、まとまった文章を書くのに苦労している人は多いのではないでしょうか。 この記事では、まとまった文章を作るときの技術を学ぶことができる記事や学習コンテンツを紹介します。新人エンジニア向けです。 文章の「型」を学ぶ まとまった文章を書くには、「型」が必要です。頻繁に使うものは、「型」を覚えてしまいしましょう。 バグレポートの書き方を学ぶ エンジニアとして書く文章の代表例が、バグレポートです。 バグレポートでありがちな失敗として「何が問題だと思っているのか」が伝わらないというものがあります。 これを防ぐために、「期待する結果」「実際の結果」「再現手順」の3つを必ず書くようにしましょう。 質問の書き方を学ぶ エンジニアが扱う技術は、最初はわからないことだらけです。 それを解決するために、質問の文章を作成する技術が必要となります。 概ね下記の4つの情報があれば、良い
もし書くことがなくなったら、俺らは一体なんなんだ - シロクマの屑籠
書くことがなくなった - phaの日記 リンク先の文章がアップロードされた時、半目でそっと、逃げるように全文を読んだ。読んではいけないものを読んだ気分になった。 それから丸一日が経ち、寝る前に再び「書くことがなくなった」というタイトルを思い出していたら、おなかが痛くなってきた。心に引っかかっていることがある時の、そういう腹痛だとすぐにわかった。やっぱり他人事ではなかったのだ。他人事ではないから逃げるように読み、ブックマークすることもツイッターで言及することもなかった。が、腹痛をとおしてこれが自分の問題だとハッキリ認識した。たぶん、私と同じぐらいの年齢の、だんだんオンライン上で文章を書かなくなっていった人たちも他人事ではないだろう。 phaさんが言う「書くことがなくなった」の内実はどういうものだろう？ あくまでオンラインの、無料の、すべての人に公開された領域に書くことがなくなったのか。それと
新卒でエンジニアになった頃に学んだ、報告の書き方｜nacam403
新卒で社会人になって以来、ソフトウェアのエンジニアをかれこれ10年近くやっています。そんな私が、新卒で入った会社の最初の配属先で、上司の上司に教えられた報告の書き方について紹介します。 報告には意味を書くその人は「報告には意味を書くこと。」と常々言っていました。「ただ単にやったこと、起こったことを書いたものは"日記"。その意味を書かないとダメ。日記が許されるのは新人のうちだけ」だと。 ダメな例：「○○の設計はxx日に完了。現在は実装中。」 こういう週報を書くと、「これは日記だよ」と指摘されます。設計がxx日に完了したことが、チームやプロジェクトにとってどういう意味をもつのかが書かれていないからです。この報告は、例えば以下の様に改善できます。 改善した例：「○○の設計は、予定通りにxx日に完了。・・・」 これならば、「設計がxx日に完了 → これは予定通りである。順調である。」という意味が盛
【更新】創作する人は必読！書評家が下読みで感じた「応募小説の問題点」がめちゃくちゃタメになる
杉江松恋＠5/3博麗神社例大祭し29-a @from41tohomania 職業は書評を中心としたライター業です。東方project奮戦中につき、ツイートは東方成分多し。現在は地霊殿中です。普通の日常報告についてはブログでどうぞ。他に言及する話題は古典芸能や、翻訳ミステリーについてなど。フォローもリムーブもご随意に。【新規】ゲラなどの送付物はプリントアウトでいただけると助かります。 mckoy.cocolog-nifty.com/hansei/ 杉江松恋＠3/31東方名華祭A-06 @from41tohomania 下読み中。すごもり生活の反映なのか、作者の私生活をそのまま描いたものが散見される。でもね、あなたがよほどの有名人ではない限り、私生活は平凡で退屈な題材なのです。日常をそのまま書いておもしろい作品は存在するが、それは文章が素晴らしいから。文章の天才でないのなら物語性で工夫しないと
文章力を上げる方法 - 山下泰平の趣味の方法
文章力を上げるための一番効率が良い行動は、大学入試で求められる程度の小論文を書くためのトレーニングを受けることだと思う。小論文対策は需要があるので、それなりのコストをかけて作られている。良いものがあるんだからそれを使えばいいわけで、意味の分からない方法で文章力上げようとする必要はない。 はっきりいって、大学入試で求められる程度の小論文を書ける以上の文章力を求められることは、普通に生きてたらほとんどない。かなり社会的な地位がある人でも、ずっとそのくらいの技術でやってることすらある。 大学入試対策の小論文通信講座的なものはわりとあるので、それを受講したらいい。どの通信講座が良いのかはよく分からない。長く続いているサービスで普遍的な内容なら、どれでも一定以上の水準は満たしているはずなので、好みで選んだらいい。どっちかっていうと理系のやつのが良いかもしれないけど、内容を知らないからはっきりしたこと
執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら
中村明博（編集者） @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、！ 2021-03-05 12:14:24 中村明博（編集者） @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 2021-03-05 14:37:22 中村明博（編集者） @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人
『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech
理科系の作文技術（リフロー版） (中公新書) 作者:木下是雄発売日: 2016/10/14メディア: Kindle版 いまさら紹介するまでもないけど、とりあえず作文方法を学びたい時は、まずはこの「理科系の作文技術」を読むことをお勧めする。 最近ブログのエントリをざっと書いてそのまま公開してしまうことが多かったので、少し反省し、それを直すためにこの本を改めて読み直した。そうしたら、タイトルで全部言い切っているのだけど、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った。 日常的にメールや、ブログの記事など、それなりの量の文章を書くことが多いけど、論文や雑誌の記事など、きちんと他人の目を通した上で公開される文章を書くことは、まずない。一度だけ、雑誌の記事原稿を書いたとき、自分なりにかなりの推敲を重ねたつもりでも、プロの編集の方から見れば言葉使いや、
ドキュメントの文章校正には、textlintが便利 - Cybozu Inside Out | サイボウズエンジニアのブログ
こんにちは！ 開発部 テクニカルコミュニケーションチーム（以下、TCチーム）の原嶋です。 さてさて。 みなさん、ドキュメントの文章校正（以下、校正）ってどんな風にやっていますか？ 目視チェックでバッチリだぜ！という方も もちろんいると思うのですが、チェックポイントが多いと指摘が漏れてしまいがちですよね。そして、会社の公式文書となれば、チェックポイントはあれもこれもと山のようになります。 TCチームでも長年 校正に頭をかかえていましたが、textlint と＋αのツール を使って、校正の悩みを解決しました。 今回はその経緯をお話させてください。 校正って確認する項目がたくさん TCチームでは、サイボウズ製品のユーザーサポートコンテンツ（ヘルプやリリースノートなど）を作成しているのですが、 それらのコンテンツは会社の公式文書なので、毎回の校正でチェックする項目が多々あるんです。 校正おわったー
LINE社内テクニカルライティング講座第2弾！1文では説明が終わらない文章を書くコツ
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
提案書の書き方、徹底解説～提案書のストーリー・コピー・デザインの基本法則【スライド付】 | knowledge / baigie
PowerPoint歴23年、デザイナー歴20年、経営者として10年以上に渡って自社のマーケティングやセールスに深く関わり、提案書を作ったコンペでの勝率91%を誇る私の知見を余すことなく注ぎ込んだ、『最強の提案書を作る方法～伝わるストーリー・コピー・デザインの法則』というスライドを公開しました。 便宜上「提案書」としていますが、企画書、営業資料、ホワイトペーパー、社内文書など、人を動かすために作られるすべてのビジネス文書に応用できるはずです。 提案書のストーリー、コピー、デザインに関する、実践的かつ具体的なノウハウを詰め込んでいます。デザインについては、プロのデザイナーではなく一般のビジネスパーソンを対象とし、仕事の中で本当に必要な知識だけをまとめています。 約170ページある本スライドは、私が企業向けにこれまで20回以上行ってきた有料講座の配布資料を元に、公開用に仕上げたものです。スライ
誰にも読まれなくても文章を書く - phaの日記
もう20年くらい、ずっと文章を書いている。最初は趣味で、ウェブ上の日記に思ったことを書いたりしていただけで、読むのは知り合いくらいだったのだけど、いつの間にか顔も知らない人に読まれることが増えて、書くことでお金をもらうようにもなった。 だけど、文章を誰かに褒められたり、文章でお金をもらえたりするとうれしいのはうれしいけれど、それはあくまで二次的なものだという意識がある。 僕が文章を書くのは自分のためだ。自分が何かを考えたいから書くし、自分が何かに納得したいから書く。書かないといつまでも同じところを堂々巡りしてしまうけれど、書くと思考や人生が前に進むような気がする。 生物というものが食べ物を摂取して排泄するように、自分にとって何かを読んで何かを書くことは、生きることと一体化しているような感じがある。 いや、もっと大きい理由は、書くことに圧倒的な快楽があるからだ。どんな快楽よりも文章を書くこと
Amazonの従業員が学ぶ伝わる文章構成の極意｜Sangmin Ahn
こんにちは、Choimirai School のサンミンです。 【主要なアップデート】 （2023.10.01）ベゾス氏がパワポを禁止した理由を語った動画を追加 （2020.05.11）Blitzscaling、ビル・ゲイツのコメントと英語版リンクを追加 （2020.05.11）知的生産の技術に関するコメントを追加 0 はじめに ▲アマゾンの社内プレゼンテーションで、パワーポイントの使用が禁止されているのは、かなり有名な話。 会議では、冒頭のおよそ15～20分間、参加者全員にドキュメントを読むための時間があてられる。ドキュメントは６ページと長い場合も多く静まったミーティングルームで参加者が黙々とドキュメントを読む雰囲気はかなり緊張感が漂っている。
簡単に真似できる文章上達術｜ベイジ社内勉強会資料
2019年3月26日に社内で実施した文章力をアップするための勉強会の資料です。プロのライターのようなハイクオリティな文章ではなく、ビジネスパーソンが仕事をする上で最低限機能する上での「上手な文章」を、とても簡単な3つに絞って話をしています。実際の勉強会ではワークもしてもらいました。皆さんもこれを読んで、実際に手を動かして自分の文章を添削してみてください。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
社内チャット、マナー云々以前に明瞭な文章が書けない人が多くてつらい
