質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
深く考えられない人は、圧倒的に文章を書く量が不足している - 自分の仕事は、自分でつくる
たとえば、デザイナーという仕事。 文章とはあまり関係がないように思っている人は少なくありません。しかし、物事を深く考えることができて、多くの人から共感されているデザイナーは文章によるアウトプット量が多く、文章力も高い。企画書も書ければ、コピーライター顔負けのキャッチコピーを書ける人もいます。私の後輩のプロダクトデザイナーもブログを書いていて、人気が出ています。 深く、粘り強く考えることができないと、詰めが甘い仕事しかできません。当然、ミスも増えますし、何かを提案しても一人よがりになり、共感してもらうことができない…。 だからこそ、深く考えられるようになることが大切で、そのためには文章を書く量が大きく影響します。言い方を変えると、文章を書く量が少ないと、いつまで経っても仕事の質は上がらず、詰めが甘いままです。決してうまい文章、美しい文章を書く必要はありません。自分の考えをまとめて、文章でアウ
FINDJOB!終了のお知らせ | FINDJOB!
FINDJOB! 終了のお知らせ 2023年9月29日にFINDJOB!を終了いたしました。 これまでFINDJOB!をご利用いただいた企業様、求職者様、様々なご関係者様。 大変長らくFINDJOB!をご愛顧いただき、誠にありがとうございました。 IT/Web系の仕事や求人がまだ広く普及していない頃にFind Job!をリリースしてから 約26年間、多くの方々に支えていただき、運営を続けてまいりました。 転職成功のお声、採用成功のお声など、嬉しい言葉もたくさんいただきました。 またFINDJOB!経由で入社された方が人事担当になり、 FINDJOB!を通じて、新たな人材に出会うことができたなど、 たくさんのご縁をつくることができたのではないかと思っております。 2023年9月29日をもって、FINDJOB!はその歴史の幕を下ろすこととなりましたが、 今後も、IT/Web業界やクリエイティブ
無職の父と、田舎の未来について。（9/24追記） - さのかずやブログ
思ってたより、深刻だった。 いま僕は、来週から始まる教育実習のために実家に帰省している。 僕の実家は、北海道の片隅にある。どれくらい片隅かというと、これくらい。 大きな地図で見る 実家には事務職をしている母と、高校３年の妹、 そして今年の春から無職の父がいる。 今回、父の就職活動を少しだけ覗き見る機会があった。 そこで僕が父を見て感じたこと、父を取り巻く環境を見て感じたことが、 いままで自分が思っていた「田舎」のイメージと大きく異なっていた。 東京都心から５時間と５万円、あるいは１万円と１２時間離れたこの町。 都会に出ていく田舎者として、田舎のために何かできるだろうかと思い、 とにかくこの状況を多くの人に知ってもらいたい、と思った。 そのために、少しでも多くの人に知ってもらうために、 いまこうして文章にしようと思った。 拙い文章ですが、田舎の現実を知ってもらうため、 できるだけ多くの人に読
敬語「させていただく」「させていただきます」を誤用してしまう理由と正しい使い方。
今回は敬語の「させていただく」「させていただきます」の誤用問題について考えてみましょう。 インターネットで「させていただく」「させていただきます」を検索しますと「させていただく症候群」とか「させていただきます 誤用 乱用」といったキーワードが入った記事タイトルが多数見つかりました。「させていただく」「させていただきます」問題には、侮り難い深い病理がひそんでいるのかもしれません。 大辞泉は「させていただく」を以下のように説明しています。 させていただ・く 相手に許しを請うことによって、ある動作を遠慮しながら行う意を表す。「私が司会を―・きます」 また新語探検は、次のように解説。 させていただく 最近の若者に目立つことばづかい。もともとは、自分の行為を相手に許可してもらい、それによって相手に対してへりくだった気持ちを表すことばだが、最近では「私は○○高校を卒業させていただきました」とか「先生の
プレゼンやブログが伝わる文章の基本。良書に学ぶ「書く技術」 | お土産屋さんブログ
皆さんはプレゼンしたことや、ブログを書いたことありますか？ わたしの初めてのプレゼンはとてもヒドい内容で、10人の参加者全員が「？」状態でした。 その後、上司にみっちり絞られたのを今でも覚えています。 叱られてもなお「何が分からないと言うんだ！」「何で理解できないんだ！」と、相手の理解力の無さを「伝わらない」原因にしていました。 しかし、名著「考える技術・書く技術」を読み、初めて自分の伝え方に問題があったんだと知りました。 今回は、わたしを変えてくれたバーバラ・ミント著「考える技術・書く技術」を紹介してみようと思います。 １．伝わる文章の大前提 ２．ピラミッドの「良いガイド」になろう ３．どうやって読み手と対話するのか？ ４．どうやって疑問を湧き起こさせるか？ ５．どうやって「答え」を出すのか？ 伝わる文章の大前提 バーバラさんは言います。 キミは自分の思いを他人に伝えたいと思ったことはあ
好意的な印象を与える実用的なメール作成 １３の技術 ＜ インターネット・IT ｜ RapidHack（ラピッドハック）
好意的な印象を与える実用的なメール作成 １３の技術 2012 年 2 月 5 日 12 時 40 分 インターネット・IT ■ 名前は必ず2つ以上使う ありきたりな文章でも、固有名詞を入れることで特別な印象を演出できます。 ■ 質問メールは二回まで 人は三回連続で質問をされると不愉快に感じるという心理的データがあります。 ■ 質問された場合の返事は文末に入れる お誘いなどの返信をする場合、前文から入れるのではなく文末に入れると余裕のある雰囲気になります。 ■ 自分の話しは後付け程度に押さえる 基本は相手の話だけに集中しましょう。自分の話ばかりでは相手が付き合ってあげてるになりかねません。日記になってしまいます。 ■ 夜中や早朝に送るメールは絵文字が派手でないものを 起きがけや、照明の暗い環境の場で読むことが予想される場合、絵文字は時に目の毒になります。 ■ 忙しいあの
文章を頻繁に書かない人にも役立つ「物書き10の原則」 | ロケットニュース24
「ホワイト・ティース」、「直筆商の哀しみ」などの作品で知られる英国作家のゼイディー・スミスさんが、昨年英ニュースサイト「guardian」に、自らの作家としてのルールを掲載した。その内容は大変機敏に富んだものであり、作家・ライターだけでなく、すべての職業に当てはまる素晴らしいものだ。 この原則は昨年2月、同サイトが英国中の作家を集めて、それぞれの物書きとしての原則を掲載したものである。いずれの作家の原則も素晴らしいのだが、取り分けゼイディーさんのものは、人生のあらゆる場面に置き換えることができるルールなのだ。 【ゼイディー・スミスさんの、物書き10の原則】 1． 子どものときには、たくさん本を読むと良い。ほかのことをやる以上に、読書に時間を割く。 2． 大人になったなら、自分が他人になったつもりで、自らの書いたものを読み返す。自分の宿敵になったつもりで読むとなお良い。 3． 自らの職業をロ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://www.yomugakachi.com/article/165347403.html