質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
エンジニアの心技体 - dwango on GitHub
ドワンゴ 技術コミュニケーション室の塩谷（ kwappa ) です。 2019年、ドワンゴには19名の新卒エンジニアが入社しました。一般研修やグループ会社との合同研修を経て、4/22からはエンジニア研修が始まっています。 その冒頭に「エンジニアの心技体」というテーマでぼくが話す時間を作りました。エンジニアとして成果を出し、成長し、生きのこるための心構えを「親父の小言」的に紹介しています。 スライドはこちらです。 前提知識として、ここ数年話題に上ることが増えてきた「心理的安全性」と「HRT」などを紹介し、その上でプロのエンジニアとして生きのこり成果を出すための心構えを「心技体」という軸で切り取って紹介しています。 「心理的安全性」という言葉が注目を集める結果となったGoogleのプロジェクト・アリストテレスについては時間的な都合で言及していませんが、平易に書かれた重要な文章ですので、あわせて
エンジニアが何か問題にぶつかったときにあるといい力を5個 - Mitsuyuki.Shiiba
最近ちょこちょこ相談されることがあって、直接のスキルではないけど、こういうのもスキルだよなぁって思ったので、思いついた順に書いてみる。5個になった。 ## 1. 問題を切り分ける力 「これがなぜか動かない」って相談されたときって、いくつかの要素が絡んでることが多い。 なので「ここは明らかに問題ないでしょう」という一番土台のところからチェックを始める。そうすると「え？そこは問題ないと思いますよ？」って言われるので「うん、それを『問題ないと思う』じゃなくて『問題ない』って断言できるようにしようと思って」みたいな会話をよくする。 可能性をひとつずつつぶしていくと「ここだなぁ」って場所が見つかって、そしたら、もうあとはそんなに難しくない。ひとつずつ確認していくのって遠回りに見えるけど、結局その方が確実ではやいと思う。 ## 2. 想像と事実を切り分ける力 ↑と絡んで、想像や思い込みなのに、「ここは
闇雲な「JavaじゃなくてKotlinやりたい！」という気持ちが消えた理由 - Mi in progress
前置き 先日このようなツイートをしたのですが、予想以上の反響を頂いて驚きました。 知的好奇心・エンジニアとしての漠然とした成長の観点から、「JavaよりKotlinやりたい」と思っていたが、現在自分たちが抱えているプロダクトの課題を俯瞰すると、「重大な課題は、プログラミング言語を変えて解決するものではない」という結論に至った。— つくし 𝕄𝕚𝕤𝕒𝕜𝕚 𝕄𝕒𝕜𝕚𝕟𝕠 (@T5uku5hi) 2018年9月12日 ツイートを読み返し、「この書きぶりだと様々な文脈を憶測できてしまうな」と思い、140字では書ききれなかった文脈の部分を本記事で書き起こすことにしました。 結論 知的好奇心・エンジニアとしての漠然とした成長の観点から、「プロダクトの言語をJavaからKotlinに変更したい」と思っていましたが、 「事実・課題・解決策」に対する認知能力の向上 言語仕様をトレードオ
『アドラー心理学』をエンジニアの目線で解釈すると？ - Qiita
Ateam Hikkoshi Samurai Inc. Advent Calendar 2017 24日目です。 本日はエイチーム引越し侍 おじさんエンジニアの@keki(37)が担当します。 この年齢になってくると、人の気持ちとか感情、考え方というところに興味がわいてくるんですね。 そんな中、数年前に出会ったのが今回のタイトルにもある『アドラー心理学』です。 エンジニアはプログラミングという専門的な業務に専念することもあり、人とのコミュニケーションが苦手だ、チームの輪に加わるのが下手だと言われることがあると思います。 また、人間関係に悩んだり、うつ病を煩ってしまったり...というケースも多い職種だと思います。 『アドラー心理学』は、そんな人間関係の悩みを解決する為の考え方、思想そのものだと、私自身感じています。 今回、そんな『アドラー心理学』を、実際現場でエンジニアをやってる私が、エンジ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
