質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
遅延評価勉強法だと得られなかったもの - As a Futurist...
ハッカーは遅延評価勉強法をするものだそうです。確かに僕の知ってるすごい人達は、皆必要になった時の吸収力が半端無くて、それを紹介した時には自分の方が詳しかったはずなのに、あっという間に追い抜かれてしまいます。 僕はハッカーになりたいけどハッカーじゃない人間ですが、やはり大上段から入って時間をかけて勉強していくのは嫌いなので、基本的には遅延評価勉強法をしてきました。でも言葉どおりに「必要になるまで」勉強しなかったら、得られないものが多すぎるなと最近感じてます。それは「普遍的な知識」です。 自分の仕事や興味だけに従っていると、訪れる機会は必然的に偏ります。たとえば web アプリの開発ばかりやっていれば、LL や HTTP や通信の知識は幅広く身につくかもしれませんが、スマホ開発や仮想環境やハードウェアなどはなかなか身につきません。必要にならないんだから勉強しなくていいんじゃない？というのはもち
ポータブルなwebアプリケーションとそのインフラの未来の一考
naoya さんのポータブルな Web アプリケーションを受けて最近思ってることをば。140 文字で時々書いてるんだけど、まとまりがないので一回まとめておきます。 12-factor app ステートフルなアプリケーションについては、Heroku の人が提唱してる 12-factor app というのが現在の状況をよく表してます。 The Twelve-Factor App The Twelve-Factor App（日本語訳） Heroku や他の PaaS によってもたらされたこうした一種の”制約”によって、アプリケーションの新しいカタチが生まれてきています。引き算によって新しい価値が生まれてきているわけですね。 とはいえ、PaaS は PaaS でそれぞれに独自の仕様を持っているわけですが、Heroku の buildpack という仕組みを使って、Heroku とインタフェース仕様
突然のTwitter砲にもなんとか耐えたさくらVPSに感謝する - As a Futurist...
なんか、2/6 の夜に「修士論文の代わりに退学願を提出してきた」が Twitter でばずったらしく、Yahoo 砲よろしく突如としてアクセスが集中しました。下の方にリソースモニタリングのグラフを貼りつけてますが、今までがほぼ 0 に見えてしまうくらいに来てたのでびっくりでした。 まぁ色々コメントつけて頂いたりしてますが、もう2 年も前なんでこのエントリについて今更僕から突っ込むことは無くて、あのエントリはあのエントリとして見て頂ければと思います。ここでは今回そんな突然のアクセス集中にも見事耐えてくれたさくら VPS に感謝しつつ、アクセス集中の状況を鯖管的立場から分析してみましょう。 ちなみに、以前エントリに書いていますがサーバの構成としてはさくら VPS1 台で、CentOS+Apache+mod_fastcgi+PHP-FPM+MySQL5.5(InnoDB)で WordPress
GNU Parallelがすごすぎて生きるのがつらい
皆さん今日もたくさんのサーバを相手にされていることかと思いますが、いくつかのサーバにアクセスして 1 秒間の統計情報(例えばvmstat 1 2)を集めてパッと表示したい時ってどうやってますかね？shell script を学びはじめたばっかりの僕はこんな感じで書いてました。 $ for i in host1 host2 host3; do ssh $i "vmstat 1 2 | tail -1"; done 0 0 0 329004 210836 14275360 0 0 0 2424 1410 1828 0 0 100 0 0 0 0 0 3716112 587704 25921684 0 0 0 488 1643 2026 0 0 100 0 0 1 0 0 555440 265560 14015548 0 0 0 4204 1534 2392 1 0 99 0 0 vmstatと
人間には二種類あるけど、優劣はない - As a Futurist...
「アイデアのつくり方」を読みました。こんなに「小さく」「薄く」「文字が大きい」 本なのに、すごい内容のある本でした。というか、ものすごい自信がにじみ出ている本で、 だからこそ伝えたいことが明確に伝わってきました。僕もいつかこんな本が書きたいと 思いました。 人間は二種類いる 「アイデアの作り方」でも真面目に、しかも厳しく指摘されていることだが、 人間には大きく分けて「二種類」のタイプがあると僕も思う。 本書の言葉を借りれば、「この世界を組み立て直す側の人間」と「型にはまった、 着実にものごとをやる、想像力に乏しい、保守的な人間」の二種類だ。これが生まれ持った ものか、それとも後天的な環境でそうなったのかということはどうでもよくて、 現実に 2 つのタイプの人間がいるということは、確かに事実だと思う。 また、最近見かけた以下のエントリでも、似た様なことを言っている。 そして、都会とは、直線的
Developers Summit2009 第2日目行ってきました - As a Futurist...
昨日に引き続いて，デブサミ 2009 に行ってきました．昨晩は昨日の寝不足がたたって 日付が変わる前にいつの間にか沈没していて，起きたら 7 時くらいでびびった． 9:30 目黒雅叙園 もはや慣れたもの．何か足が痛くて歩くの疲れた． 10:00-10:50 【13-A-1】 これからの Web テクノロジーを予測する 秋元さんはマスクマンで登場しました．いろいろキーワードを上げてもらっていい感じでした． 「10 年かけて一般人に覚えてもらったパスワード認証というインタフェース」を OpenID に移行するのには 確かに障壁があるよなー．SSH の公開鍵だって未だに使ってない人多いでしょ？ ともかく，何でも作って公開してみること．次は常に来る．Google が終わる世界だって容易に想像できる ぐらいの想像力を持って開発をしたいもんだ． 11:10-11:55 【13-E-2】アート・オブ・ア
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
