タグ

ブックマーク / blog.riywo.com (8)

  • 質の高い技術文書を書く方法 - As a Futurist...

    大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは? 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 番環境に変更を加えるにあたっての包括的な情報や具体

    質の高い技術文書を書く方法 - As a Futurist...
    ngsw
    ngsw 2021/01/28
  • 私とソフトウェア - As a Futurist...

    英語とソフトウェアは、自分が学んできてまともに使えるようになったただ二つのものだ。英語は自分に物理的な解放を与えてくれたが、ソフトウェアは自分に精神的な解放を与えてくれた。というわけで、英語については以前振り返ったけど、ちょうど Software Engineer へとジョブチェンジできたタイミングなのでソフトウェアも自分用に振り返っておこう(最近記憶力が。。。)。なお、僕は生まれついてのギークでは全くないので、そういう人への参考にでもなれば幸い。 中学・高校 家には親が買った PC があって最初は Windows 3.1 だったんだけど、ちょうど Windows 95 が出てフロッピーディスクを何枚も入れ替えながら更新するという今では貴重な体験をしたりしていた。でも、その PC で何やってたかというと、プログラミングなんて全くやってなくて、パソコン雑誌についてる CD-ROM からゲーム

    私とソフトウェア - As a Futurist...
    ngsw
    ngsw 2019/01/05
  • オペレーションエンジニアとは何かを理解するために「ウェブオペレーション」を読んで欲しい

    最近は、@kazeburo さんの真似をして自分も「オペレーションエンジニア」と名乗ろうかと思ってます。正直最初にオペレーションエンジニアって聞いた時、なんのことだかよくわからなかったんですよね。ちょうどこの言葉を最初に見たのは 1 年前くらいで、その時僕は 2 年目に入ったところで MySQL Conference から帰ったばかりで「おらは DataBase Administrator(DBA)なんだ!」と思ってた頃でした。 それからちょうど 1 年。1 年目の時も DB だけをやってたわけではないですが、この 1 年はより広くより深くいろんなモノを見てきた関係で、自分の仕事は「DBA」だけだとちょっと説明に足りないなぁと思ってたところで、「オペレーションエンジニア」という言葉を思い出しました。そう、僕の仕事は「オペレーションエンジニア」なんです。ひよっこだけど ん、ちょっと待てって?

    オペレーションエンジニアとは何かを理解するために「ウェブオペレーション」を読んで欲しい
    ngsw
    ngsw 2011/05/17
    この記事に感動した(´;ω;`)ブワァッ / ここまで大きなWebサービスの運用はできてないですが、他部署の人と会話して何かしら情報を仕入れるようにしたい。
  • 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と

    GNU Parallelがすごすぎて生きるのがつらい
    ngsw
    ngsw 2011/04/20
    GNU Parallel やばい。関係ないけどParallelsはもっとやばい。
  • 「出過ぎた杭」を目指してみませんか? – 新卒エンジニアに向けて - - As a Futurist...

    新卒準備カレンダー 2011 春というおもしろい企画がありまして、3 日目は自分が担当させて頂くことになりました。@shibukawa さんの様に抽象的なレベルまで高めて書くほどの経験は残念ながらありませんので、僕ものんべんだらりと自分語りをしたいと思います。 Who are you? DeNA のサーバインフラエンジニア新卒 2 年目(=もうすぐ 3 年目)です。主な言語は Perl とshow slave statusです。プログラムやコンピュータに結構詳しい学生さんでも、インフラって何やってるのかについてはイマイチ伝わらないことが多いのですが、一応説明しておきます。僕は大してコードも書いてませんし、かといってプロジェクトマネージャみたいに人の管理もしていません。僕が相手にしているのはシステムが動いているコンピュータ(=サーバ)そのものです。システムの多くは無数のサーバが通信しあって提

    「出過ぎた杭」を目指してみませんか? – 新卒エンジニアに向けて - - As a Futurist...
    ngsw
    ngsw 2011/03/04
    『ひとつ「出過ぎる」と、他にも「出過ぎてくる」』←これはあると思う。ぴんとはったビニールに指突き立てる感じ。一点が飛び出すと周りも浮き上がる。
  • 突然のTwitter砲にもなんとか耐えたさくらVPSに感謝する - As a Futurist...

    なんか、2/6 の夜に「修士論文の代わりに退学願を提出してきた」が Twitter でばずったらしく、Yahoo 砲よろしく突如としてアクセスが集中しました。下の方にリソースモニタリングのグラフを貼りつけてますが、今までがほぼ 0 に見えてしまうくらいに来てたのでびっくりでした。 まぁ色々コメントつけて頂いたりしてますが、もう2 年も前なんでこのエントリについて今更僕から突っ込むことは無くて、あのエントリはあのエントリとして見て頂ければと思います。ここでは今回そんな突然のアクセス集中にも見事耐えてくれたさくら VPS に感謝しつつ、アクセス集中の状況を鯖管的立場から分析してみましょう。 ちなみに、以前エントリに書いていますがサーバの構成としてはさくら VPS1 台で、CentOS+Apache+mod_fastcgi+PHP-FPM+MySQL5.5(InnoDB)で WordPress

    突然のTwitter砲にもなんとか耐えたさくらVPSに感謝する - As a Futurist...
    ngsw
    ngsw 2011/02/07
    awk熱いっす。$9==200とかはじめて知りました。
  • 退学して就職した2009年をやっと振り返ってみた - As a Futurist...

    あけましておめでとうございます。あまりの忙しさに結局年内に 2009 年を 振り返ることができなかった riywo です。実家に帰って、多少時間ができたので そろそろ書いてみようかと思いました。とはいえ、もう 2 日後には仕事が始まるという 状態ではありますが。。。 大学院に退学願を提出したのが 2009 年だったということをすっかり忘れてしまうくらいに、 ものすごい変化をした 1 年でした。あの頃が遥か昔に感じられます。 さっき改めて、「修士論文の代わりに退学願を提出してきた」を 読み返してみました。このエントリはまさに退学願を提出したその足で 2 時間くらいで一気に書いた 文章になりますので、かなり荒削りなものになっていますが、あの大学院の 2 年間で 積もり積もったものを書き連ねたものですので、今でも全く気持ちは変わっていません。 改めて当時の分析を振り返ると共に、そこからの変化とい

    退学して就職した2009年をやっと振り返ってみた - As a Futurist...
    ngsw
    ngsw 2010/01/03
    きらきらとまぶしいエントリ。
  • UbuntuでPlaggerやるならこれでいけ!〜VirtualBoxからcronまで〜 - As a Futurist...

    インストールがむずかしいことで評判の「Plagger」ですが,その評判通り 使える様になるまでが大変です.一般的には,CPAN から Plagger を入れれば いいのですが,依存関係が複雑なのと make しながらになるのでやたらと 時間もかかり,一発で入らなかったりと,面倒なことだらけです. この度,さくっと入れる方法が確立できたのでここにメモしておきます. Ubuntu 環境ないよという人のために,Virtualbox という仮想環境に Ubuntu を 入れるところからスタートします.Ubuntu 持ってる人は飛ばして下さい. そして,何よりパッケージを作ってくれた半袖さんには ちょー感謝><! VirtualBox に Ubuntu 入れる VirtualBox とは Sun が提供してるフリーの仮想環境ソフト.これで仮想マシン (こちらをゲストと呼びます)を作ってそこに Ubu

    UbuntuでPlaggerやるならこれでいけ!〜VirtualBoxからcronまで〜 - As a Futurist...
    ngsw
    ngsw 2009/01/07
  • 1