質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
私とソフトウェア - As a Futurist...
英語とソフトウェアは、自分が学んできてまともに使えるようになったただ二つのものだ。英語は自分に物理的な解放を与えてくれたが、ソフトウェアは自分に精神的な解放を与えてくれた。というわけで、英語については以前振り返ったけど、ちょうど Software Engineer へとジョブチェンジできたタイミングなのでソフトウェアも自分用に振り返っておこう(最近記憶力が。。。)。なお、僕は生まれついてのギークでは全くないので、そういう人への参考にでもなれば幸い。 中学・高校 家には親が買った PC があって最初は Windows 3.1 だったんだけど、ちょうど Windows 95 が出てフロッピーディスクを何枚も入れ替えながら更新するという今では貴重な体験をしたりしていた。でも、その PC で何やってたかというと、プログラミングなんて全くやってなくて、パソコン雑誌についてる CD-ROM からゲーム
サンフランシスコ生活始めました - As a Futurist...
サンフランシスコからこんにちは。今日からひとまず 1 年間、アメリカのサンフランシスコで仕事をすることになりました。だいぶ前から言っていた夢がひとまず叶ってとてもハッピーです。 今回、日本の会社からの出向という形でアメリカの会社で働くことになりましたが、アメリカで働くというのがこんなにも大変で面倒なことなのかと思い知らされました。ビザの取得に始まり、日本で住んでいるところの処理やアメリカでの住宅探し、銀行や携帯電話など今まで当たり前に持ってたものがないこと、仕事の引継ぎ(業務自体や評価)、保険や税金などの違い、などなど。今回は会社にたくさんサポートをしてもらえて本当に助かりました。 また、諸事情あって 10 月頭という当初の予定から 1 ヶ月遅れてしまったのですが、9 月からの 2 ヶ月間に本当に色々な方から「いってらっしゃい！がんばれよ！」と言って頂けて大変ありがたかったです。イクイク詐
データマイニング+WEB 勉強会第9回に参加してきた - As a Futurist...
なげーよ！！！！というわけで、TokyoWebMining という勉強会に参加してきました。 いつも人気の勉強会ですぐに ATND 埋まってしまうんですが、たまたま空いてるタイミングで ポチっとできたので参加させて頂きました。 勉強会の詳しいまとめは主催の@hamadakoichiさんがよくまとめられているので こちらをご覧ください。 第９回 データマイニング+WEB 勉強会＠東京 ( #TokyoWebmining #9) －2nd Week－方法論・ソーシャル祭り－ を開催しました 個人的な感想を書くと、やめちゃった大学院とかでは機械学習とか近いところにいたので もともと興味はあって論文とかも読んだり、OpenCV 使ったりとかしてたんですが、 まぁ素人の知識くらいしかないので会場の Ph.D.率の高さに頭が上がらない感じでした。 学問も中途半端、エンジニアとしても全然コード書けてない
今更CAP定理で分散データストアの勉強を始めてみた - As a Futurist...
長くなったので三行でまとめると CAP 定理を素人なりに調べてみた 分散データストアを CAP 定理で俯瞰してみた どのデータストア使うかの決定因子は CAP 定理的な視点の方がインタフェースとかより先 異論は認めるというか、専門知識ゼロなのでもっと正しい理解があればぜひ教えてくださいませ。 はじめに 僕は MySQL 厨なんですが、最近はやれ「MongoDB がいい」だの「HBase 最高」だのとよく聞きます。これら多種多様なデータストアを語る上で、「RDBMS VS NoSQL」みたいに問い合わせ言語の方式やデータ保存形式の違いで語るのは宗教論かなぁと僕は思ってます。単体プロセスのデータストアとしての特徴とか性能とかは正直なんでもいいかなぁと。 思うに、本質的に重要なのは MySQL の master-slave&sharding という Web で今までスタンダードに使われてきた分散
「リーダブルコード」が良書すぎて胃が痛い - As a Futurist...
インフラ系のエンジニアは、あまりリファクタリングとかクラス構造といった視点でコードを読む機会が少なくて、勢い作ったスクリプトやツールはそれはそれはひどいものになりがちです(体験談)。 僕もエンジニアになって以来、まともなコードなんか書いたことなくて、従ってる原則といえば、「グローバル変数は悪」とか「短いことはいいことだ」とか「コメントは書かない方がいい」とか、なんか学生の時にたまたま目にしたよくわからない何かに従ってる程度。 少し大きい規模を書き始めると、昨日の自分と今日の自分で命名規則が全然一貫性なくて、「getHoge()」と「makeFuga()」がおんなじようなことをやってたりしていつも嫌悪感に駆られてました。 ちょうど 1000 行くらいのアプリ書いてたところだったので毎日吐き気をこらえながら「まずは動くものをつくるんだ。全てはそれからだ」と言い聞かせて汚いコードをゲロゲロしてた
そろそろやりたいこと決めないと - As a Futurist...
最近、この先どうするかなぁと考えることが多い。大学院辞めてから 2 年ぐらいはお金稼ごう・仕事できるようになろうと必死で食らいついてきたんだけど、ある意味視野が狭くって、それしか見えてなかった。2 年ぐらいずっとおんなじ仕事だったんだけど最近ちょっとやること変わってきたのと、色んな人とお話する機会があって、なんか色々考える様になった。 頭では理解したつもりだったけど、本当に色んな人がいる。今はエンジニアの人と話す機会が多いけど、その限られた分野でも本当に千差万別。エンジニアとしてだけじゃなくて、人間として尊敬できる人もたくさんいて、ふと自分を振り返った時にそう思われる人になれてるのかなぁと思うと、とてもそんな気がしない。 僕がこの職業始めた理由は「飯の種を獲得するため」だった。でもあんまり目線の高い目標じゃないし、幸いにもうまくいってそれなりに技術は獲得できた。なのですぐに切り替えて「すご
「出過ぎた杭」を目指してみませんか？ – 新卒エンジニアに向けて - - As a Futurist...
新卒準備カレンダー 2011 春というおもしろい企画がありまして、3 日目は自分が担当させて頂くことになりました。@shibukawa さんの様に抽象的なレベルまで高めて書くほどの経験は残念ながらありませんので、僕ものんべんだらりと自分語りをしたいと思います。 Who are you? DeNA のサーバインフラエンジニア新卒 2 年目(=もうすぐ 3 年目)です。主な言語は Perl とshow slave statusです。プログラムやコンピュータに結構詳しい学生さんでも、インフラって何やってるのかについてはイマイチ伝わらないことが多いのですが、一応説明しておきます。僕は大してコードも書いてませんし、かといってプロジェクトマネージャみたいに人の管理もしていません。僕が相手にしているのはシステムが動いているコンピュータ(=サーバ)そのものです。システムの多くは無数のサーバが通信しあって提
退学して就職した2009年をやっと振り返ってみた - As a Futurist...
あけましておめでとうございます。あまりの忙しさに結局年内に 2009 年を 振り返ることができなかった riywo です。実家に帰って、多少時間ができたので そろそろ書いてみようかと思いました。とはいえ、もう 2 日後には仕事が始まるという 状態ではありますが。。。 大学院に退学願を提出したのが 2009 年だったということをすっかり忘れてしまうくらいに、 ものすごい変化をした 1 年でした。あの頃が遥か昔に感じられます。 さっき改めて、「修士論文の代わりに退学願を提出してきた」を 読み返してみました。このエントリはまさに退学願を提出したその足で 2 時間くらいで一気に書いた 文章になりますので、かなり荒削りなものになっていますが、あの大学院の 2 年間で 積もり積もったものを書き連ねたものですので、今でも全く気持ちは変わっていません。 改めて当時の分析を振り返ると共に、そこからの変化とい
修士論文の代わりに退学願を提出してきた
退学って「お願い」するもんなんだと初めて知りました．というわけで，前々から 言っていた通りに，大学院に退学願を提出してきました．専攻ではすでに修士論文の提出も 発表も終わっているそうです．いつ行われたのかも知りません．とりあえず 4 月からはちゃんと就職して働きますのでご心配なく．日本はやさしい国ですね． さて，ここで大学に対する恨みつらみを書いてもしょうがないので， これから（日本の一般的な）大学・大学院を目指すという方に対して， これは考えておいた方がいいんじゃないかということを書き連ねておきます． 大学に入って 6 年しか経っていないし，学会にも行ったことのない人間の 戯れ言ですので聞き流しておいて下さい． **【さらに追記】**2 年ぶりになぜか注目されました Twitter が一般にも浸透したんだなぁと勝手に感慨にふけっています。@su319 さんが Toggeter にまとめて
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
