質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
関大岩本ゼミのアドミン on Twitter: "大学生の日本語作文力がたまに話題になりますが、この文書を事前に配るだけで相当まともな文章を書いてきますよ。 https://t.co/5cl952luR2"
大学生の日本語作文力がたまに話題になりますが、この文書を事前に配るだけで相当まともな文章を書いてきますよ。 https://t.co/5cl952luR2
死にたくない
結婚することになった。 ひどい失恋をして仕事もうまくいかなくてもう一人で生きて死ねばいいと思っていたのに急に出会った相手と結婚することになった。 お互いの親に挨拶が済んでこれから住まいを一緒にして入籍や挙式の準備を進めている。 借金があった。 学歴はなかった。 借金は整理しつつあるが仕事は日々の暮らしはなんとかなっているという程度でたっぷり貯金があるわけでもないし人との付き合いが苦手で職場で出世もできるかわからないし一生楽にしてやれる約束なんてそうしたい気持ちはあるがたぶんできない。 でもそれでもいいのだという。子供もいつか持てればいいけれども二人で一緒に生きることが出来ればどちらでもいいと言ってくれる。 病気をしたり疲れすぎて倒れていると泣くほど心配をしてくれる。 親や兄弟にも否定され友人もいなく仕事で強く求められるわけでもない自分の事を。 こいつは頭がおかしいんじゃないか、なにか裏があ
らばQ:心にズドン…90歳の老人が語る45の人生の教訓
心にズドン…90歳の老人が語る45の人生の教訓 年の功とは言ったもので、人生経験を積み重ねた人の言葉には重みがあります。 お年寄りの語るちょっとした助言の中には、人生を歩んでいくためのヒントが隠されていることが少なくありません。 アメリカ・オハイオ州に住む、齢90歳になるリジャイナ・ブレットさんが「人生が自分に教えた45のアドバイス」を書かれています。 含蓄あるものが数多くありますので、ぜひご覧ください。 1. 人生は公平では無いけれど、それでもいいものだ。 2. 疑わしいときは、次の一歩は小さく歩もう。 3. 誰かを嫌うには人生は短すぎる。 4. 病気になると仕事は自分の面倒をみてくれない。友人や家族がしてくれるのだから連絡を取っておこう。 5. クレジットカードの支払いは毎月全額支払っておくのだ。 6. すべての口論に勝たなくていい。反論にも賛成してみよう。 7. 誰かと一緒に泣こう。
はてなブログ | 無料ブログを作成しよう
来年も作りたい！ふきのとう料理を満喫した 2024年春の記録 春は自炊が楽しい季節 1年の中で最も自炊が楽しい季節は春だと思う。スーパーの棚にやわらかな色合いの野菜が並ぶと自然とこころが弾む。 中でもときめくのは山菜だ。早いと2月下旬ごろから並び始めるそれは、タラの芽、ふきのとうと続き、桜の頃にはうるい、ウド、こ…
ユーザサポートでめちゃくちゃ感謝された経験について話す - はてなポイント３万を使い切るまで死なない日記
もう１５年前にぐらいになるが、僕の仕事のやりかた、ユーザにたいしてどうやって向き合っていけばいいかについての信念を決定づけたある事件について語ってみようと思う。ほぼ懺悔にも近い。 ぼくが企画したモデムがバカ売れした。無名のブランドだったのにもかかわらず発売した瞬間に、秋葉原のショップで１番の人気モデルになった。理由は他者のモデムが無骨な段ボール箱にはいっていて、いかにもコンピュータの部品っぽかったのに、ぼくのモデムはカラフルな化粧箱をつけて、とても初心者が使いやすそうに見えたからだ。実際、簡単そうにみえる化粧箱をつくるのに何回もつくりなおして半年以上もかかった力作だった。 当時windows95が登場してインターネットが話題にのぼりはじめたあたりで、いままでマニアのパソコン通信ぐらいしか用途がなかったモデムをインターネットという単語に引き寄せられた大量の初心者が買い始めた時期で、とにかく簡
昔集めてた名言集みつけた
作者名が抜けまくってます。さすがに補足する気力なし。サーセン・・・orz 上手に引用をしたいなら、すぐれた読み手でなければならない（アルコット） 人生の前半は楽しむ能力があってもそのチャンスがなく、後半には楽しむチャンスがあってもその能力がない（マーク・トウェイン） 競争は最高の商品を生み出す、最も醜い人間をもたらす。 危機という言葉は二つの感じで出来ている。ひとつは危険、もうひとつは好機である（中国のことわざ→ＪＦケネディが引用） 共に生きることを学ばなければ、ともに愚か者として亡びるであろう 楽観的な人はトゲではなくバラを見る。悲観的な人は、バラに気づかずトゲを見る 話すことは知識の本領を発揮することであるが、聞くことは知恵の特権を享受することである。 権利には責任が、機会には義理が、所有には義務が伴う（ロックフェラー） 平等の欠点は、われわれが目上の者との平等のみを求めることだ（ヘン
バナナはおやつに入りますか
小泉総理時代民主党「バナナはおやつに入りますか」 小泉「あなたが入ると思えば入るし、入らないと思えば入らない」 民主党「総理は質問に答えていない。入るのか入らないのか」 小泉「あなたね、おやつかどうかは心の問題ですよ。あなたはどうなんですか」 安倍総理時代民主党「バナナはおやつに入りますか」 安倍「入るかどうかは大事な問題で、適切に判断しなければならない」 民主党「総理は質問に答えていない。入るのか入らないのか」 安倍「入るかどうかで八百屋と駄菓子屋のどちらかに迷惑がかかるので慎重にならざるを得ない」 福田総理時代民主党「バナナはおやつに入りますか」 福田「バナナですか？あれ黄色いですね」 民主党「総理は質問に答えていない。入るのか入らないのか」 福田「そんなこと知りませんよ。あなたが考えてください」 麻生総理時代民主党「バナナはおやつに入りますか」 麻生「なんで、そんなこときくの？」 民
テキストに知性があるかないかを見分ける10のポイント - ハックルベリーに会いに行く
面白いとは何だろう？「知識」のプライオリティは下がっている町山智浩さんのブログを読んでいたら、興味深い一節に突き当たった。 オイラはものをあまりよく知らない。昔はそれを恥ずかしく思っていたし、よくバカにされてきた。でも、今はなんとも思わない。なぜなら、ネットの時代、知識は誰でも簡単に拾えるようになったので、知識そのものに価値がなくなったからだ。いや、それは言い方が違うな。本当に物知りなのか、ネットで拾っただけの知識なのか見分けることが困難になったからだ。ちょこちょこっと検索して、それを散りばめれば物知りに見える文章は作れる。「鎮」という漢字が読めない知ったかぶり「雑学王」 - ベイエリア在住町山智浩アメリカ日記 なるほどこれは確かにそうかも知れない。インターネットやIT機器の発達で、情報というものはこれまでと比べて格段と調べやすく、また引き出しやすい環境になった。だから、以前のようにそれを
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
その文章、どうやったらわかりやすくなりますか？～文章をわかりやすくする【18個】のルール～