大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
ちょっとまえ、面白い記事をツイッターで拝見した。 企業の採用担当が、面接時に見ているポイントを端的に表現したものだ。 曰く、「事実と意見を分けて説明できるかは圧倒的に重要で、これができない人はかなり厳しい。」とのこと。 クローズな勉強会などで話をしたら好評だったのでブログに書きました / 面接時に見ているポイント – VOYAGE GROUP techlog https://t.co/64ehNAYLAi — Masanori KOGA (@makoga) October 29, 2019 彼がこれを重視する理由としては 「事実と意見を分けて説明するのがうまい人が書いた障害報告書は読みやすい」とある。 確かに読みやすい文章を書く人は、知的能力が高い事が多いので、採用の精度は良いのではないかと推測する。 ただ、この文章を読んで感じるのは、 「なぜ「事実」と「意見」を区別して話せない人がいるの
By OnInnovation オンライン決済サービス「PayPal」の母体を作り、世界で最も成功しているEVメーカー「テスラ」の創設、民間宇宙開発のトップをひた走る「スペースX」を立ち上げた経歴を持つイーロン・マスク氏の成功はこれらにとどまらず、超高速交通網を開発する「ハイパーループ」、都市の地下にトンネル網を張り巡らせる「Boring Company」などの構想をうち立てるなど、そのアイデア力と経営手腕は非常に高いものがあります。そんなマスク氏が数年前にテスラの従業員宛に送ったというメールには、組織としての強靱な体力を実現するために必要な社内コミュニケーションの在り方が雄弁に語られています。 This Email From Elon Musk to Tesla Employees Describes What Great Communication Looks Like | Inc.c
先日AbemaTVに出演した。ある日なぜか会社宛にオファーがあり、興味本意で引き受けた。その実態は、想像以上にテレビで、制作進行もテレビ朝日できっちりしているし、視聴者層もスマホからネットにアクセスするようになった層という感じがした。 僕が出た番組は、AbemaPrime。21-23時に放送しているニュース番組。メイン演者は、ケンドーコバヤシさん。僕はコメンテーターという立ち位置だった。トピックは、パチンコ規制と蓮舫氏の戸籍公開、飲みニケーションの是非だった。正直なんとも言えない。とりあえず若者視点での意見を期待されてるのかと思ったが、もう一人のゲストが24歳のうめけん君であることを知り、完全にポジションを失ったまま番組に突入した。 余談だが、僕はここ2年半ほどは会社を立ち上げ仕事に集中するため、メディア・イベント系の依頼は断っていた。だから久々の出演だった。討論系はNHKなど色々経験した
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
