技術と重要に関するmythmのブックマーク (3)
-
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる1枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
-
僕の専門は﹁人材開発﹂です。そのような研究分野で仕事をしていますと、﹁人材育成に関するさまざまな嘆き節﹂を耳にする事があります。 たとえば、もっとも耳にする嘆き節といえば、これです。 ﹁昔はきちんとOJTが機能していたのに、最近、それが機能しなくなってきたよねー﹂ この台詞、皆さんも、きっと、これまで、様々な場所で、耳にしたことがあるのではないでしょうか。 経験的には、上記の﹁OJT機能不全の嘆き節﹂は、主に、人材育成の担当者の方、ラインのマネジャーの方から発せられることが多いような気がします。 しかし、それが﹁なぜか﹂は、あまり語られることがありません。 今日は、この問題について、先行研究を踏まえながら、考えてみましょう。 ちなみに、ここでいうOJTとは﹁上司・先輩と新人・若手のあいだの垂直的な発達支援関係﹂と定義します。 ▼ 結論を一言でいうと、日本の企業におけるOJTとは、 ﹁OJT
-
2016年にもなって、まだ醤油に関してこんなことを言っている人がいるとは……という記事がありました。 こちらなんですが、読まなくていいです。PVを稼がせるのもあれなんで、URLはhを取る昔ながらの手法です。 ttp://kininal.me/recommended-food01-soy-sauce/ 全項目に関してツッコミどころが満載という、ものすごいひどい勉強不足の記事です。このサイトで醤油のことに関して書いているのはこれが初めてじゃなく、空気に触れない容器の醤油は危険とかいうこれまたひどい嘘記事を書いていたことがあったので、もうきちんと修正をしてやろうじゃないかと。 こういう記事に関して、どれだけ真に受ける人がいるのかはわからないんですが、世間一般に言われている醤油に関する誤解は一度きちんと解いておいた方がいいのではと思いました。よくよく考えてみたら、書籍や同人誌では書いていても、We
-
1
質の高い技術文書を書く方法 - As a Futurist...
最近、職場で「OJT」が機能しないのはなぜなのか？（中原淳） - エキスパート - Yahoo!ニュース
醤油にまつわる誤解をきちんと解いてみよう - 醤油手帖
