質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
良質のアウトプットは「出がらしのお茶っ葉」からは生まれない!? | 立教大学 経営学部 中原淳研究室 - 大人の学びを科学する | NAKAHARA-LAB.net
「良質なアウトプット」を行うために必要なものは、「十分なインプット」と「適度なスループット」を確保することです。 ここで「十分なインプット（input）」とは、「自己の外部から、世の中の最先端を走る知識を、十分仕入れること」を意味します。 一方、「適度なスループット(throughput)」とは、「外部からたくわえた知識を自分のなかで咀嚼したり、他人と対話しながら、自分の腹におとすこと」をいいます。 これは僕の経験談でしかないのですが「インプットースループットーアウトプット」、このバランスがうまく保たれているときに、「良質なアウトプット」が確保できます。 自分でいうのも何ですが、今から２０年弱前、駆け出しの助手（助教）時代などは、このバランスが比較的保たれていたような気がします。 しかし、年をとるにつれてか、法人化の影響か、僕のタイムマネジメントがショボイのか、知りませんが、この「バランス
アウトプットに対する苦手意識について - Lambdaカクテル
思った事とか勉強したことをまとめて書き出したり表現したりする、つまりアウトプットを、なかなか書けない時とするする書ける時というのがある。その違いは何なのかとか、アウトプットがうまくいかないときに、それを妨げている心理的障害は何なのかを掘り下げていくうちに、これ自体が一つのアウトプットになった。つまり今回は成功だ。 だいたい僕はアウトラインの途中らへんまでを構成して、そしてそれを半分くらい文章として肉付けしているあたりで厭になって辞めてしまうことが多いのだった。ブログの下書きにはそういった文書が積み重なっていて圧巻だ。 なんで途中で辞めてしまうのか。それはやはり劣等感と遠くでつながっている話であるようだった。僕はまず辞めてしまうタイミングに着目して、その時どういうふうに感じているか、自分と向き合ってみた。すると、僕がアウトプットの中途で書くのをやめてしまうのは、「大したことをやっているように
継続的なアウトプットはなぜよいか？ 著作も数多いエンジニアが語る、社外向け発表がチームまで成長させる話 - Findy Engineer Lab
渋川（@shibu_jp）です。現在はフューチャー株式会社という、一次受けでコンサルから実装から運用保守まで一気通貫に行う会社にいます。社会人になってから、特に選り好みをしたりせず、任せられる仕事はなんでもやってきました。最近多いのは、サーバーからフロントあたりの領域です。 それ以外に書籍の執筆などもしており、今年（2020年）は『Real World HTTP 第2版』が出版され、「n月刊ラムダノートVol.2 No.1」にも寄稿しました。ほかに『Goならわかるシステムプログラミング』も、増刷のタイミングで密かに12ページほどコンテンツを増やしたりしています。 近著を中心とした10年にわたる筆者の著作 キャリアや仕事の仕方について、よく周りから聞かれるのが「いつ本を書いているのか？」「なぜ書き続けているのか？」といった質問です。僕としては、どちらかというと効率マニアで、一石二鳥を狙い続け
アウトプットの品質を下げておくと気軽に書けるようになる - hitode909の日記
12月であるし、アドベントカレンダーが回っていたりして、よくできた興味深いブログの記事を目にすることが多い。 よくできた記事ばかり見ていると、自分もちゃんとしたものを出さなければ、となってしまうことがありそう。しかしちょっと待ってほしい。 ブログ記事、といっても、プロの編集の手が入ったお金のかかった記事、一人で頑張って書いた大作、チョロっと書いて出てきた日記まで様々なものがある。 100文字くらいで終わっているものもあれば10万文字くらい書かれているものもあるので、文量に1000倍の差がある。 映像の世界で1000倍の差を出そうとすると、2時間すなわち7000秒の映画と、スマホで撮った7秒の動画、くらいの差がある。 2時間で観れるすばらしい映画がなにかあるとして、 Amazon.co.jp: フォレスト・ガンプ／一期一会 (字幕版)を観る | Prime Video これの1000分の1の
アウトプットの結果はだいたい期待通りには返ってこない - みんからきりまで
ポエムです。 アウトプットに挫折してしまう人 現代のインターネット社会において、特にエンジニアなどの技術職の場合、アウトプットをすることが大切とよく言われる。 ここでいう「アウトプット」というのは、例えばブログを書いたりだとか、作品を作ったりだとか、発表をしたりだとかだ。 しかし、アウトプットをするというのは向き不向きがあるようで、苦手な人も多いようだ。 純粋にアウトプットが性に合わないという人もいて、そういう場合はそれはそれでいいと自分は思う。 決して自分の成果や能力をオープンにアピールしなくても優秀な人はたくさんいるし、そういう人は有名ではないけれど確実に評価されきちんと仕事を得ている。 一方で、アウトプットをして承認されたいと思っていながら、それが上手く出来ない人というのもいるようだ。 自分の観測範囲だと、特にアウトプットのハードルが上がりすぎていて、その高いハードルを乗り越えた結果
ブログを書き続けるための工夫とモチベーションを維持するための取り組み - このすみろぐ
write-blog-every-week Advent Calendar 2018の8日目の記事です。前日のはてブエントリー入りしたライナスさんの記事はこちら！ linus-mk.hatenablog.com このブログ(このすみろぐ)は、2017年の8月から書き始めました。実は、過去に5回ほど同じようにブログを始めたことがあるのですが、それらはすべて三日坊主に終わっています。 色々と試してみた結果、今回こそはブログを続けていけそうですので、試行錯誤の過程を共有してみます。 ブログを書き続けるために工夫したこと 三日坊主を防ぐための課金という選択肢 今まで開設してきたブログは、すべて無料ブログでした。ブログを始める度に三日坊主ではあまりに情けないので、不退転の決意を固めるために、課金してみることにしました。 はてなブログProの契約 独自ドメインの取得 ドメインまで取得してしまったので、
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
