質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
僕のしょうもない人生を紹介します
大西拓磨です。21歳、ニートです。 このたび、縁あって、ここで何か書いていい権利をいただき（、そこから半年が経ち）ました。 とりあえず、僕のここまでの人生をザバーと紹介して最初の記事と代えようと思います。 1999-2011 横浜で、両親の反対を押し切って生まれました。父と母が毎日のように喧嘩している間、僕はどちらの膝にも座れるのが楽しかった思い出です。 内気ながら足が速かったので小学校では男1女6で遊んでたし、うち2人に告白されました（ここで自殺しておけば...）。 これはその頃に描いた船の絵と その間取りです。 2012-2014 3分の1が東大に行く中高一貫男子校に入れさせられましたが、勉強嫌いだったのでずっと遊んでました。 雪だるまに土下座させたりとか、 ポテトで悟空作ったりして。 あとずっとパズドラやってた。無課金で属性一面+297を達成したのは僕が史上初でした（伝わらない）。
ちょっと自慢させてくれ
7歳の娘に「20ヶ月後は何月でしょうか？」って問題を出したら、 3秒ぐらいで「2月！」って答えてびびった。 数えるのが早すぎるので「どうやってわかったの？」って聞いたら、「4を引いた」って。 親のほうがまだ理解できていないので、更に聞いてみると 「1年は12ヶ月だから、20-12＝8。12-8＝4。だから、6月から4を引いた」って。 すごくない？ 「わかんなーい。」「じゃぁ、一緒に数えてみようか」 ってやり取りを期待していたのに、計算で求めるとは想像もしなかった。 少なくても、僕が同じ問題を出されたら8ヶ月後を指を折って数えると思う。 これだけで算数の才能があるかは判断できないけど、パパはちょっと期待しちゃうよ。 ------- 追記：6月20日 23時 人気エントリーに入っていてビビった。 3秒は言いすぎたかな？5秒ぐらいかな？ 親への説明はこんなにスムーズじゃなかったです。 でも、こん
『お見合いや初デートでその話をするなって何べん言ったら分かるんじゃい！男性編』
ショックで夜も眠れず昼間が眠いです。日本全国にもショックで仕事が手につかないOLが山ほどいるはずやから今週と来週くらい会社全部休みにした方が良くない？ ね、そうしよ！ みんなちょっと休んでメンタル立て直そう！ 今日のテーマは、 男子の 「お見合いで、 したらあかん話」 です。 私、この仕事始めて、 よく思うんですけど、 男子マジ 頑張ってる いやほんまに！ 店探しにしても、 会話を盛り上げる努力にしても。 正直ね、 美味しい店とか女子の方が絶対知ってるって！ だって女子は女友達と会う時、 女の先輩後輩と会う時、 いっつも素敵な店探して行ってるやん！なんぼでも雰囲気いい店を探してきたやん！ 男子が友達とか先輩後輩と会う時なんか、 小汚くて大漁旗がある居酒屋 （1人3000円くらいの喫煙OKのとこ） が普通やって！ もしくは家飲みやって！ 男同士やったらそれが普通やって！ 男同士で 「春田さん
ペットボトルを机に置いてください。出来たらあなたは合格です。 - ペットボトルを机に置いてください。出来たらあなたは合格です。（グレブナー基底大好きbot） - カクヨム
これから最終面接が始まる。 観葉植物が並んでいる小綺麗な廊下で、僕は呼ばれるのをじっと待っていた。膝の上に置く拳に汗がじわじわと滲む。ここまで来るのにどのくらいの手間と時間がかかったことか。 僕はスーツのポケットから小さな鏡を取り出し、ネクタイが曲がっていないか確認する。次にジャケットのボタンを見て、一番下がちゃんと外れていることを確認する。最後にポケットのフタを中へとしっかりしまう。ばっちりだ。 数学科の僕の就活は酷く難航していた。まず、アピールすべきポイントが見つからない。同じ理系でも化学や生物などの実験系の分野は「こういう研究をしました」「新しい事実を発見しました」などの自分の結果がある。しかし、数学科は往々にして研究結果を持たない。厳密には、３、４年大学に通ったくらいでは研究までたどり着けないのだ。 数学科では、ひたすら教科書や論文を読み、先人たちの知恵や知識を頭に蓄える。その作業
書面でお願いいたします - Everything you've ever Dreamed
業績の悪化、止まらぬ人材流出、それから、社内政争での連敗が祟り、我が営業部は独占的に使っていたフロアを追い出され、倉庫がわりにしていた窓際スペースに引っ越しとなった。12月頭のことである。 引越しに伴い書類を整理した。日付の書かれたダンボール、ダンボール。中身を検分して保管、廃棄、懐の三択。そのなかに、ファイルもされず会社の封筒に突っ込まれただけの書類があった。 とある独立行政法人の役務委託入札関連のものだった。裏金やマージンを要求する輩には、たまにお目にかかるけど、自分がグレーであることを自覚しているだけマシだ。けれども、にゃほん原子力ほにゃららという独立行政法人の担当は、それこそ清廉潔白という顔で「行為」をしていたのでタチが悪い。 数年前のことだ。そのころのウチの会社はノリノリで、新しい客層の獲得に力をいれていた。そうしたキテル感のウェーブに乗っかってその独立行政法人の役務、食堂運営と
参加した事業説明会の人間力がヤバすぎた。 - Everything you've ever Dreamed
とある事業説明会に参加した。開始十分前の会場は三代目Ｊソウルブラザーズのような若者たちと年金生活をしているような老人たち約二十名に占められ、アマちゃんのテーマ音楽がかけられていた。そんな客層と、安直な音楽セレクトが醸し出すインスタントな感じが僕の不安を増幅させた。今考えるとこのとき帰るべきであった。 配られた資料に目を落とすと太文字でこうあった。「私たちは新たな価値を想像します」。表紙で誤字とかふざけてるのか。想像はジョンレノンだけにしてくれ。帰ろう。僕が椅子から立ち上がった瞬間、闇。アマちゃん完全に沈黙。いつの間にか正面のスポットライトのなかにはおばはんが登壇していた。こうして悪魔の事業説明会ははじまったのである。 「…一応仕事ですけど、家族のように頑張ります」おばはんの挨拶は不明瞭なまま終わった。詳細は省くが、おばはんは挨拶の締めで滝川クリステルのアレを二度、繰り返した。アレは美女がや
大学ってなんだろう
現在大学3年生。某県某大学に通っている。ちな理系。前期、僕はある講義を受けていた。普通の座学。その講義はお昼前に開講されている講義だったので、講義の後半になるにつれ腹が減ってくる。んで学内の食堂ってのは大体、講義が終った直後くらいに学生で埋まっちゃうから、講義が早く終わるかどうかってのは空きっ腹抱えたナウでヤングな学生達にとってはそりゃもう死活問題。講義終了30分くらい前に某SNSを覗いてみると「腹減ったー。さっさと終われ、この [ココに最高に汚い言葉が入る] 講義！」など、それ教授の前でも同じこと言えんの？的なトゥイートがちらほら。どんだけ食欲旺盛なんだ（昼前の講義に限らずどの講義でも大体こんなもんだけどね）。しかしその日はたまたま、本来の終了時刻より20分くらい前に講義終了の雰囲気になった。いつもは時間通りに終わらせる先生だったからかなり珍しい。先生は今週の課題の説明をした後に、一言「
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
INTERVIEW: 菅野よう子
BBAに引っかかって大変だった話をする : キニ速