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

唐突ですが意見表明をします。今後のテレビ出演ではいじめ、決めつけ、ステレオタイプ、ジェンダー差別、ステマ、ファクトチェックされていない情報流布になるべく抵抗することにしました。生放送では勿論やりますが、収録ではカットされてもやります。以下、長く深くなりますが私の考えを解説します。

2024年9月13日、「普通の人が資産運用で99点をとる方法とその考え方」が日経BPから出版されました。詳しくはこちら。 はじめに 資産運用で 99 点をとる方法とその考え方について説明します。この記事の対象はいわゆる「普通の人」です。 資産運用は趣味ではない。 資産運用を始めてみたいが何をしてよいのかわからない。 資産運用をすでに行っているが毎年ころころと方針を変えてしまっている。 資産運用に無駄に時間ばかり費やしている。 今のところ資産はすべて銀行の普通口座や定期預金にいれている。このまますべて現金でおいておくのも何か損しているみたいでモヤモヤする。だけど難しいことは勉強したくないし時間も使いたくない。 といった人たちです。 記事では最初に結論、すなわち「やるべきこと」を述べます。資産運用で 99 点の投資効率を達成するためにはこの結論部分だけを実行するだけでよいです。 次に、それだけ

鴻上尚史の人生相談。レッスンや芝居の勉強に投資を続けてきたが、これ以上役者の道を続けるべきか悩む30歳女性。「鴻上さん、あなたならどんな言葉をかけてくれますか？」と問う相談者に鴻上尚史が示した俳優を続けるために必要な、ある才能とは？ 【相談40】役者の道を諦めて他の道に進むかどうか悩んでいます（30歳　女性　あい） 鴻上さん、こんにちは。私は役者の道を諦めて他の道に進むべきか悩んでいる30歳です。 今まで、沢山レッスンや芝居のお勉強へ投資をしてきました。時間も使ってきました。 名の知れている事務所や劇団に入れても、オーディションでは中間審査などで弾かれたり、履歴書に堂々と書ける経歴は殆どありません。 経験を積むためにニューヨークでミュージカルの勉強もしてきました。それでも大きな実績を作れませんでした。 自分がこれまで受けた膨大なレッスンから受け取ったものや自分の才能を信じて今までやってきま

5月に『アイデア大全』を読んで以来、同書に書かれている「発想法」をいくつか試している。『アイデア大全』については下記記事で感想をまとめているので、詳しくはそちらをどうぞ。 アイデアを生み出すための手法が、42個も掲載されている本書。当然、すぐに全部を実践できるはずもないので、暇なときにちょちょいと読み直しつつ試している格好。 そんな発想法のうち、継続的に取り組んでいる手法がひとつある。 『アイデア大全』を最初から最後まで読んだうえで、特に「これはぜひとも実践したい！」と感じられた手法。6月上旬から取り組むようになり、この2ヶ月以上、なんだかんだで続けられている。それどころか楽しんですらいるし、メリットと言えそうな効果も現れてきている。 それが、「ノンストップ・ライティング」だ。 スポンサーリンク テーマなし＆時間制限ありのフリースタイルが楽しい！ 「ノンストップ・ライティング」 あるいは「

2018年4月25日をもちまして、 『CodeIQ』のプログラミング腕試しサービス、年収確約スカウトサービスは、 ITエンジニアのための年収確約スカウトサービス『moffers by CodeIQ』https://moffers.jp/ へ一本化いたしました。 これまで多くのITエンジニアの方に『CodeIQ』をご利用いただきまして、 改めて心より深く御礼申し上げます。 また、エンジニアのためのWebマガジン「CodeIQ MAGAZINE」は、 リクナビNEXTジャーナル( https://next.rikunabi.com/journal/ )に一部の記事の移行を予定しております。 今後は『moffers by CodeIQ』にて、 ITエンジニアの皆様のより良い転職をサポートするために、より一層努めてまいりますので、 引き続きご愛顧のほど何卒よろしくお願い申し上げます。 また、Cod

自己肯定とかどうすりゃいいの なにをどうしたら息を吸ってるだけでオッケー！！って思考回路になるの？ 運動瞑想睡眠野菜350g以外で まず人生はクソゲーなんですよ。 遺伝子パラメーターからランダムで、容姿が選べなくて、親が選べなくて、国が選べなくて、人種が選べなくて、性別が選べなくて、スタート時点での所持金(家が金持ちかどうか)で、受ける教育や生活の余裕も変わってくるわけで、国によっては満足な教育も医療もなく内戦で大混乱だったり、こんな超絶理不尽なゲームはないわけです。 では、「クソゲー」って概念はなぜ生まれるかというと、神ゲーと比較するからなんですね。神ゲーがあるから対比としてクソゲーという概念が生まれます。もし世の中に「クソゲー」しかなければ「クソゲー」という概念は生まれません。 例えば、ファミコン初期に出た「忍者ハットリくん(100万本以上の大ヒット)」「アトランティスの謎」「スペラン

このホッテントリに関連して、たまたまちょうどよいサンプルを見かけたところなので、ささっとエントリーに仕立ててしまいたい。 rentwi.textfile.org おっしゃることはごもっともだと思う。心情的には同意したい。しかし、数式には、結城先生が連ツイ中で例として引いている漢字や英語にはない怖さがあると思う。その怖さは、むしろ「文系」の人より「理系」の人のほうが、わかってもらえるんじゃないだろうか？ つまり「数式アレルギーの理系」の人がいたっておかしくないんじゃなかろうか？ どころかアレルギーの度合いは、ひょっとしたらそういう人の激しいんじゃなかろうかとすら想像する。 怖さというのは、数式の難易度が、見た目からは即座に判断できないということが、ままあるということだ。 スポンサーリンク こんな数式がある。 標準正規分布の確率密度を与える関数である。「理系」の人間だったら、知らないと恥ずかし

こんな記事を読みました。 プロブロガーやフリーランスや地方移住を掲げてしまうイケハヤの犠牲者たちへ 繰り返し言うけど、言及したブログは特別に責められるような内容じゃないし、イケハヤ的なカテゴリに当てはめて書いちゃうのも若いんだから当然。僕だって20歳くらいの頃はすごく馬鹿な考え方をしてた。具体的に言うと家に引きこもってゲームしながらいつか自分には可愛い彼女ができるんだって漠然と考えてた！若い頃ってそんなもんじゃね？中身の本質とは、ほとんど関係ない話で恐縮なんですが、僕も20歳くらいの時は今以上にバカだったなあ、と思ったので書いてみます(なんか昔も書いたりしたかもしれないけど)。 20歳くらいの時の周りの大人20歳くらいの時に何をしていたか、というと、僕はミルクカフェというサイトをやったり、1ch.tvというのをやったりしていました。 で、高校時代くらいまでは「大人」といえば、学校の先生とか

高所得者が「オレは運が良かっただけ」と言うのはポジショントークであることが多いので、鵜呑みにしない方がいい。 彼らは、ある意味、イカサマ賭博をやっている。 このイカサマの正体を暴いてみる。 冷静に分析すると、私の知り合いの高所得者たちは、以下の様な特徴が多い。 ・人よりも多くのことを試す。 ・上手く行かなかった時に損切りするのが素早い。 ・「たまたま」上手く行ったら、その幸運を全力の全力で最大限利用して、スキル、実績、人脈、資産を得る。 ・一度スキル、実績、人脈、資産を得たら、それらを最大限に利用して、さらなるスキルと実績と人脈と資産を作り、それらが雪だるま式に増えていく。 ・運任せの大博打はしない。確実性の高い勝算のあるときだけ大きく賭ける。 ・人よりも多くの不運を想定し、不運を事前に回避するための手を人よりも念入りに打っている。 ・不運に見舞われたときのダメージを最小限にするための保険

この画像を大きなサイズで見る 内向的な人と外向的な人の違いについて、さまざまなことが言われているが、内向的な人の頭の中では、どんなことが起こっているのか、イラストで解説しよう。 このイラストを作成したのは、リズ・フォスリエンとモリー・ウェスト。よく内向的な人は、社交嫌い、退屈というレッテルをはられているが、多くの人は内向的なことと、外向的なことは必ずしも行動選択の違いではないことに気づいていない。 研究によると、内向的な人の脳は、社交的・外向的な人とはまったく違うやり方で情報を処理しているという。外向的な人は外界からの刺激を素早く処理するが、内向的な人は情報を扱う神経経路が長くて、処理に時間がかかるのだ。イラストを見てもらえば、内向的な人への見方が変わるかもしれない。 1.内向的な人は刺激情報を処理する神経経路が長い この画像を大きなサイズで見る 内向的な人は刺激情報を処理する神経経路が長

新人の開発者が繰り返し突き当たるテーマがあります。プログラム言語を1～2種類勉強するのに時間を費やしたり、プログラミングの演習を行ったりすることに関して問題はないと感じていても、学んだことをどう応用していいのか分からずにいるのです。このことは、次のようなフレーズとしてよく耳にします。「プログラムの書き方は知っているが、何をプログラムしていいのか分からない」と。これに対する答えは、一般的に、「プログラミングの課題を行いなさい」、「オープンソースプロジェクトに貢献しなさい」、または、「ゲームを作りなさい」というようなものです。 プログラミングの課題を行うことは、知的ないい訓練にはなります。しかし新しいプログラムの開発方法を学ぶのにはあまり役立ちません。オープンソースプロジェクトに貢献するのは確かにステップアップになります。実際のプロジェクトがどのように構成されているか学び、プログラム言語の技術

恐怖は不快な感情であり、現実もしくは想像上の危険、喜ばしくないリスクに対する強い生物学的な感覚である。 生き物として避けるべきことを示すサインであり、安全への退避行動を起こす役目を果たすものである。 恐怖をもたらす対象を避けようとすることは至極当然の行動だと言える。 たとえば、人間が恐怖状態に陥ると、心拍数や呼吸数の増加し、脚などの筋肉に血液が集中し、回避行動の準備に入る。 しかし、恐怖をもたらすものに、繰り返し触れようとする嗜好が存在する。 恐怖を主題として読者に恐怖感を与えるためにつくられた創作物は数多い。 また遊園地に設置されている遊具（アミューズメント・ライド）の中で、絶叫マシン（スリル・ライド）と呼ばれるジャンルが今も優勢を誇っている。 これらはすべての人に愛好されている訳ではないが、根強い人気を誇っており、中でも愛好者は繰り返しこれら恐怖刺激に触れることを嗜好する。 これら恐怖

以下の記事を読んで。 530000micro.hatenablog.com 僕が勤めている会社では、原則、プログラムにコメントを書かないのがルールです。 人生で初めてプログラムに触れてからこのかた、プログラムには必ずコメントを書けと指導されて来ましたし、自分自身も、後輩たちにちゃんとコメント書けよと言い聞かせてきました。そんなわけで、最初に全然コメントのないソースコードの山を見たときは、正直「ゲッ、なんじゃこりゃ……」と面食らったのは確かです。 ところが、「なぜうちのプログラムにはコメントがないのか？」と同僚に尋ねてみると、実に納得の行く回答が返ってきたのでした。 なぜコメントが必要なプログラムを書くのか？ 同僚いわく、「コメントが無くても読めるようなプログラムを書け」という思想が根底にあるのだそう。 適切に関数や変数が命名され、スコープがきちんと管理され、ロジックの流れが整理されているコ

常日頃からライフハックを駆使して時間節約を試みている私たち。確かに、塵も積もれば山となるのですが、若いころ無駄にした膨大な時間は、いくら後悔しても取り戻せません。 今振り返ると、筆者にはシステマティックに時間を捨てていたような悪習慣がいっぱいあったような気がします。 そこで、まだ間に合う人のために、筆者が若いころ時間を無駄にしていた悪習慣をいくつかお伝えします。これらを避けるだけで、かなりの時間とエネルギーの節約になるはずです。 時間の無駄1：助けを求めない大学を出てすぐに入った会社でのことです。最初の週、上司に膨大な集計表を渡されました。 ｢整理しといて｣と言われたものの、私にはちんぷんかんぷん。無口で臆病者の私は、ただうなずいて席に戻りました。そして、何かわからないものかと、1時間ほどそれを眺めていました。 それでもわからなかったので、ようやく近くの先輩に、何をしていいのかわからないと

以下の記事を読んで思ったことなど。 KONAMIの四半期利益が前年比260%を記録、ゲーマー達の想いと裏腹に成功する早川体制：DamongeNews ソシャゲやスマホのゲームにゲームの主流が移ってからというもの、ゲームというものが、新しいエンタティメント、新しい表現形態、新しい物語から、行動心理学の実践のようなものに変わってしまったように感じている。 僕は熱心ではないが、それなりにはゲームをしてきている。一番プレイしたのは、NECのPC8801mkIISRというパソコンで出たゲーム。あの当時のパソコンゲーム業界は、奇跡のような世界だった。以下に（なんとキャプチャ画像と共に）思い出の作品をリストしているので、よかったら見てみてください。 僕が惚れ込んだPC88ゲームたち：小鳥ピヨピヨ 若くて感受性が豊かだったせいもあると思うけど、当時のゲームは本当に素晴らしいものだった。ダンジョンに入ると、

強いチームを作るには時間がかかる～強いチームのつくり方（前編）。Developers Summit 2016 業務で行われるソフトウェア開発プロジェクトのほとんどすべては、何らかのチームによって行われています。そしてそのプロジェクトが成功するか失敗するかを左右する大きな要因が、技術力よりも人間系にあることはよく指摘されることです。 では、その人間系に注目して強いチームを作るにはどうすればよいのか、そのヒントを多数紹介したセッション「強いチームのつくり方」が、2月19日に行われたイベントDeveloper Summit 2016（通称デブサミ）で行われました。この記事では、そのセッションの内容を前編、中編、後編の3本の記事で紹介します。 いまお読みの記事は前編です。 プロジェクトの多くは技術ではなく人間系で失敗している 吉羽 龍太郎氏（Ryuzee.com）。 吉羽と申します。いままで野村総

人生に必要なのは金や名声ではなく「家族や友人、コミュニティーなどで豊かな人間関係を築く事」が証明された意義はでかい。これは人生を考える上で一番大切な事。俺が辿り着いた結論と同じ。毎日確認したい。 / “「80歳の時に健康であるか…” https://t.co/7UjjPifQJp — Xevra Lindich (@xev_ra) 2016, 2月 1 ハーバード大学による75年に及ぶ研究結果が凄い。これは人間の生きる指針を提示してくれる画期的な成果だ。 人間にとって一番重要なのは金でも名声でもなく 家族や友人、コミュニティーなどと関係を持って豊かな人間関係を持つ事 である事が確認された。 つまり、我々が目指すべき事は、いい大学に入る事でも大企業に就職する事でもTVに出る事でも表彰される事でもなく、家族や友人と楽しく豊かな関係を築く事だけなのだ。 私は仕事柄何千億円持ってる富豪やTVに良く