「ドキュメントの書き方」を体系的に学んだことがないエンジニアへ 書籍『エンジニアのためのドキュメントライティング』の概要
インフラエンジニア向けの書籍を取り上げ、著者と出会い、楽しく本を知り、仲間を作る場所である「インフラエンジニアBooks」。ここで、『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』の翻訳を担当した岩瀬氏が登壇。まずは、本書籍の概要について話します。 本セッションの対象者と、セッションのゴール 岩瀬義昌氏：ご紹介いただきました、岩瀬と申します。よろしくお願いします。『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』は、もともと『Docs for Developers: An Engineer’s Field Guide to Technical Writing』という洋書だったんですが、その翻訳をして、今回この機会をいただいています。 余談ですが、APC（株式会社エーピーコミュニケーションズ）さんが「カプセルト
結城浩『数学文章作法 基礎編』 - 文章を書くときに大切な「たったひとつのこと」 #book - CodeIQ Blog
CodeIQの中の人、hnanami です。 今回は、『数学ガール』の著者であり、CodeIQではアルゴリズム系問題で毎回多くの挑戦者が集まる出題者である結城 浩さんから寄稿いただきました。 ご紹介いただく『数学文章作法 基礎編』を抽選でもらえる特典が付いた問題も挑戦受付中です。この機会をお見逃しなく！ =============================== こんにちは、結城浩です。 結城はふだん『数学ガール』シリーズなどの数学読み物やプログラミングの本を書いており、CodeIQではアルゴリズム系の問題を出題しています。みなさんいつも挑戦ありがとうございます。 さて今日はCodeIQ運営さんのご厚意により、結城がこの4月に出版した『数学文章作法 基礎編』という本をご紹介したいと思います（「作法」は「さほう」ではなく「さくほう」です）。 本書は「正確で読みやすい文章を書く心がけ」を書
初心者でも今すぐできる！読まれる文章の書き方12のコツ - 自分を変える、人生を変える！
2013-02-02 初心者でも今すぐできる！読まれる文章の書き方12のコツ 文章術 一昔前と比べて、私たちが文章を書く機会は圧倒的に増えました。 ネットが普及し、個人が「情報発信の場」を持つのが当たり前になったからです。 ブログやmixi、ツイッター、フェイスブックなどをやっていれば、必ず文章を書くことになります。しかし自分の文章がなかなか読まれなかったりうまく伝わらなかったりして、悩んでいる方もいると思います。そこで今回は「読まれる文章の書き方12のコツ」をご紹介したいと思います。 高等技術を省き、できるだけ文章初心者の方でもすぐ使えるようなコツに絞ってまとめました。 1. 「何を伝えたいのか？」を1つに決める 文章には必ず「それを書く目的」があります。 目的をハッキリさせておかないと、途中で「あれ、えーと何が言いたかったんだっけ？」と迷路に迷い込んでしまいます。 そのよう
自己編集スキルを身につければ、文章は見違えるほど良くなる！ | ライフハッカー・ジャパン
筆者のCaroline McMillan氏は、ノースカロライナ州シャーロットのローカル新聞『The Charlotte Observer』の記者として、スモールビジネスやアントレプレナーの記事を執筆しています。McMillan氏はノースカロライナ大学チャペルヒル校でジャーナリズムを専攻、在学最後の2年間をデューク大学とUNCの共同出版雑誌「Rival Magazine」の主任編集者として過ごしました。今回はMcMillan氏が「よい文章のための自己編集スキル」について語ります。 多くの新聞記者と同様、私は「書くことが好き」で、「書くことが得意」なので、この仕事につきました。しかし、記者というのは厳しい職業です。あなたが最高傑作だと思う記事を提出しても、編集者から20カ所ものダメ出しが返ってきます。 それでも、そんなことを200回も繰り返せば、すっかり面の皮が厚くなります。また、「自己編集能
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
文章に向いてない構造をいかに文章に向いた構造に直列化するかが大事 - きしだのHatena
Software Design 12月号の特集が「なぜエンジニアは文章が下手なのか？」というタイトルだったので、読んでみたら、ちょっと残念な内容だった。 「それは文章で書くべき情報なのか」という章があって、直列化した論理構造であれば文章には書きやすいけど、分岐やループがあるような構造だと書きにくいということが書いてあった。そこで文章化しにくい構造の例として地図があげてあって、暗にそういう構造は文章化をやめて図であらわせと言っているように読める。 けれども、図に書いたところで、書く側は文章化から逃げれて満足かもしれないけど、それを読み取る側は結局どこかから順番に解釈していく必要がある。図に逃げるのは、読み手に責任を押し付けているだけだと思う。 で、「ですから文章を書く前にまず論理構造を考える必要があります」と続いていて、では考えた論理構造が「文章に向かない論理構造」だったらどうするの？逃げる
文章のプロ直伝！素人でもプロ並に書けるようになる５つのテクニック
ユーザーに届ける価値を徹底的に追求する マーケティングを提供します © Copyright 2022 バズ部. All rights reserved. 文章力は、ビジネスの世界で、今まで以上に非常に重要なスキルとなっている。 例えば、広告やダイレクトメールなど、消費者に向けてのメッセージは文章力に大きく依存する。 また、興味のある人に対してコンタクトを取って、アプローチする際も、あなたの書くメールや手紙などの文章の内容によって、成否は大きく左右される。 思い返せば、私は、社会に出る前の学生の頃から、大学で、大量の本を読み、週に２〜３本のエッセイを書いたり、レポートを提出したりしていた。 そして、こうやって培って来た文章力によって、ビジネスにおける様々な面で得をしていることを実感している。そこで本日は、私が実際に使っている文章テクニックを５つご紹介する。 この通りに書いて頂くだけで、プロの
わかりやすい文章の10大原則
この記事では、LINEグループに招待できない・参加できない時の対処法や原因についてお伝えしていきたいと思う。 複数人で連絡を行う際にLINEのグループ機能は非常に役に立つ。学校でも職場でも利用されている事が多く、グループ内通話も出来るので簡単な打ち合わせ程度であれば、LINEでも可能になった。 グループの作り方も非常に簡単。 しかし、なぜか相手に招待が届かない…といったことも度々ある。 では、この招待が届かない時によくある原因について見ていこう。 LINEグループに招待できない時の対処法・原因 基本的に以下の場合は、相手に招待を送っても届かない。 既にLINEを退会している(アカウントを変更している)場合 既に招待を送っている場合 相手にブロックされている場合 もしくは、招待しているけれど参加されない…といった場合は、相手側が参加を拒否している可能性もある。 上記の3点に当てはまらない場合
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
【記事紹介】［保存版］読むだけで文章力が劇的に向上する良質記事まとめ８選＋α
このまとめは凄い。ものを書くことを習慣としているからには、これは目を通さないわけにはいかない記事。まとめてくれた人に感謝。 ［保存版］読むだけで文章力が劇的に向上する良質記事まとめ８選＋α【NAVERまとめ】 http://matome.naver.jp/odai/2132649894434245001
驚くほど違う→あなたの文章を最適化するたった４つのルール
文のレベルで、日本語を明確化する工夫について取り上げた著作には、本多勝一(1982)『日本語の作文技術 (朝日文庫)』（朝日文庫）があるが、酒井聡樹(2007)『これからレポート・卒論を書く若者のために』（共立出版）が、さらなる改良に取り組んでいる。 この記事は、両著作についての私的メモの域を出ない。 なお『これからレポート・卒論を書く若者のために』は、井上真琴『図書館に訊け!』(ちくま新書)とともに、大学新入生のマストアイテム。入学する前に読んでおくと、まるでちがった４年間を過ごせるだろう。 以下では、まず日本語の文がわかりにくくなる４大原因を示し、次に４大原因のそれぞれに対応した４つの最適化ルールを提示する。最後に、それぞれのルールについて適用例を挙げて、ルールの活用法を説明する。 文が分かりにくくなる４大原因 １．一つの文に多くの情報が詰め込まれている ２．情報を与える順番がおかしい
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
サービス終了のお知らせ - NAVER まとめ
サービス終了のお知らせ NAVERまとめは2020年9月30日をもちましてサービス終了いたしました。 約11年間、NAVERまとめをご利用・ご愛顧いただき誠にありがとうございました。
そうだったのか、新聞記事の書き方！ 池上彰さん曰く 『削ることを想定して、優先順に書く』 : 非モテタイムズ編集長のガラス張りブログ
2011年01月23日08:12 カテゴリ そうだったのか、新聞記事の書き方！ 池上彰さん曰く 『削ることを想定して、優先順に書く』 先日、テレビ番組で、ジャーナリストの池上彰さんが、かつて所属していた毎日新聞を訪ねて、新聞の記事づくりを説明していました。 興味深かったのは、一つの記事に書く、情報の順番です。 噛み砕いて説明すると、最初に何を書いて、次に何を書いて、その次に･･･という順番です。 この順番には、新聞ならではのルールがあるのです。どんなルールでしょうか。 そのルールについて、池上さんは、「桃太郎の鬼退治」を例にとって、わかりやすく説明していました。思い出して書くので、細部の言葉はちょっと違うかもしれませんがお許しを。 さて、桃太郎の物語を、「起承転結」で説明すると次のようになります。 起 桃太郎が桃から生まれた。 承 鬼が島に鬼を退治に行くことになった。 転 犬、猿、キジ、
とにかく速くて論旨も首尾一貫する文章の書き方
「文は人なり」などと言うが、正しくないばかりか実用的でもない。 人が文章にできることは、考えていることのごく一部でしかない。 まして人となりなどは、言葉にするには豊かすぎるし深すぎる。 １．自己表現なら他でやれ 書きたいことなど書くな。感想も書くな。オリジナリティなどくそくらえ。 ただ書かなければならないことだけを書け。 書いている間だけは、そういう「機械」になれ。 これだけで書く速度も、読みやすさも３割増しになる。 もともと人は、書き付けた言葉を前にして「こんなの私じゃない」という違和感を繰り返し受け入れることなしには、一言だって書くことはできない。 あなたが書いた文章は、あなたではない。 いいかげん目を覚ませ。 このことが理解できない限り、誰のアドバイスも添削も、あなたは受け入れることができないだろう。 そういう人は、つまるところ、他人に見せる文章を書く資格が無い。 ２．仮面をかぶれ
書きなぐれ、そのあとレヴィ＝ストロースのように推敲しよう／書き物をしていて煮詰まっている人へ
書き物をしていて煮詰まっているという人には、いつもする話があるから、今日はそれを紹介しよう。 レヴィ＝ストロースはこんな風に書く。 「私のなかには画家と細工師がおり、たがいに仕事を引き継ぐのです。 カンバスに向うまえにデッサンをする画家のように最初の段階では、まず書物全体の草稿をざっと書くことからはじめます。 そのさい自分に課する唯一の規律は決して中断しないことです。 同じことを繰り返したり、中途半端な文章があったり、なんの意味もない文章がまじっていたりしてもかまいません。 大事なのはただひとつ、とにかくひとつの原稿を産み出すこと。 もしかしたらそれは化物のようなものかもしれませんが、とにかく終わりまで書かれていることが大切なのです。 そうしておいてはじめて私は執筆にとりかかることができます。そしてそれは一種の細工に近い作業なのです。 事実、問題は不出来な文章をきちんと書き直すことではなく
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://twitter.com/developer_quant/status/1551910433858400256
百年前の英文指南書『The Elements of Style』に学ぶ、効果的な文章の書き方11の法則 | ライフハッカー・ジャパン
sekailog.com
http://n1kumeet5.com/2011/08/atamayoibunsyo1/