タグ

2021年1月28日のブックマーク (2件)

  • 質の高い技術文書を書く方法 - As a Futurist...

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

    質の高い技術文書を書く方法 - As a Futurist...
  • 甲子園V主将裁判で主張、駒大野球部「風習」で転落 - 社会 : 日刊スポーツ

    花咲徳栄が埼玉県勢として初めて夏の甲子園を制覇した2017年の主将で、19年4月に強盗致傷事件などを起こした千丸剛(ちまる・つよし)被告(21)らの裁判員裁判が27日、千葉地裁(坂田威一郎裁判長)で開かれ、千丸被告の被告人質問が行われた。 千丸被告はスポーツ推薦で18年に駒大に進み、2月から野球部に入部した。弁護側の被告人質問で、1年春からリーグ戦に出場していたにもかかわらず、退部した理由を、千丸被告は「深夜2時、3時までコンクリートの上に正座させられたり、雨の中、傘もさせずに先輩たちの買い出しに行かされたり、たばこの火で根性焼きさせられたりしました。3月から9月に退部するまでほぼ毎日ありました」と供述。「チームの体質、風習についていけなかった」ことが退部の理由と説明した。 通学は続けたものの、駒大はキャンパスがひとつのため「顔を合わせたくない先輩たちと顔を合わせるのが苦痛になった」ため、

    甲子園V主将裁判で主張、駒大野球部「風習」で転落 - 社会 : 日刊スポーツ