中学生の時に読んだ「南くんの恋人」でラストで、１ヶ月はまともに眠れない程のショックを受けた 高校生の時に読んだ「BANANA FISH」で心を抉られ、授業中も主人公の辿った運命のことしか考えられなくなった 今読み返しても、当時のやりきれなさや行きどころのない感情をありありと思い出す おとなになってから、魂を危うい場所に連れて行ってくれる作品に出会えなくなった 博識なはてなーたちに、他にそんな作品があるか、あるいは同じような経験があったか教えて欲しい 頼んます

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