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

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

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

    質の高い技術文書を書く方法 - As a Futurist...
    qp365
    qp365 2021/01/28
  • Software engineerが日本から北米に移住すること - As a Futurist...

    自分は日からアメリカとカナダの北米 2 カ国に、労働許可を持って移住した経験があります。そういった移住/働いてみたいという方の相談にのる機会も多いのですが、共通して持っておいた方が良いなと思った情報がいくつかあるので、まとめておきます。 その前に注意事項として、以下をご確認ください。 就労に関する状況は日々変化しています。ここの情報はあくまで参考として、最新の正しい情報はご自身が行かれる際に改めて然るべきルートでご確認ください。 なぜ北米に行くのか?という問いにはこのエントリでは答えません。あくまでも移住したいというモチベーションを持っている方向けの情報になります。 自分と同じ様に日国籍のみ有していて、ずっと日で生まれ育った方に向けて書いています。細かい状況の違いは読み手側で吸収してください。 これは個人の意見であり、私が所属するいかなる組織の意見を代表するものでもありません。 認識

    Software engineerが日本から北米に移住すること - As a Futurist...
    qp365
    qp365 2018/06/09
  • 修士論文の代わりに退学願を提出してきた

    退学って「お願い」するもんなんだと初めて知りました.というわけで,前々から 言っていた通りに,大学院に退学願を提出してきました.専攻ではすでに修士論文の提出も 発表も終わっているそうです.いつ行われたのかも知りません.とりあえず 4 月からはちゃんと就職して働きますのでご心配なく.日はやさしい国ですね. さて,ここで大学に対する恨みつらみを書いてもしょうがないので, これから(日の一般的な)大学・大学院を目指すという方に対して, これは考えておいた方がいいんじゃないかということを書き連ねておきます. 大学に入って 6 年しか経っていないし,学会にも行ったことのない人間の 戯れ言ですので聞き流しておいて下さい. **【さらに追記】**2 年ぶりになぜか注目されました Twitter が一般にも浸透したんだなぁと勝手に感慨にふけっています。@su319 さんが Toggeter にまとめて

    修士論文の代わりに退学願を提出してきた
    qp365
    qp365 2011/02/07
  • 退学して就職した2009年をやっと振り返ってみた - As a Futurist...

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

    退学して就職した2009年をやっと振り返ってみた - As a Futurist...
    qp365
    qp365 2010/01/03
  • 1