タグ

2021年6月4日のブックマーク (2件)

  • プログラマーがドキュメントを書かない理由

    この記事は、著者の許可を得て配信しています。 Why programmers don’t write documentation 最近ではずっとコードのドキュメンテーションに関連した記事を書いていたので、当然、私のMediumのおすすめ記事には「開発者がドキュメントを書かない当の理由」という記事が表示されるようになりました。この記事では、ドキュメントを書くための優れたツールがないことが、ソフトウェアエンジニアが自分の作業や判断をドキュメンテーションする意欲を失わせる最大の原因について書いています。 私は普段、特定の記事を批判したりはしませんが、この記事には怒りを覚えました。このライターは図解ツールについていくつかメリットに関して述べてはいますが、全体的に誤解を招くような内容になっており、この重要な問題をより分かりにくくさせています。2つの図解ツールを比較して、どちらも不十分なツールである

    プログラマーがドキュメントを書かない理由
  • エンジニアだけど米国で足湯を開湯した話

    コロナ禍で引きこもりが加速し、創作欲求が爆発した結果、自分で足湯を設計&施工してウチのワイナリー「SUNSET CELLARS」に実装し、おそらくカリフォルニア初の格的な日式公共足湯を開湯(かいとう)しました。今週末から「Zen Zin Onsen」として営業を開始し、SUNSET CELLARSのテイスティングルームでワインを飲みながら足湯に浸かるという極上体験を誰でも気軽にお楽しみいただけます。いままでガレージをDIYしてオフィスを施工したり、業でも家を作ったりしているフルスタックエンジニア(物理)な自分ですが、今回の対戦相手は行政と水漏れ、ボイラー制御でした。小さな頃から当に温泉文化や雰囲気、エクスペリエンスが大好きで、死ぬまでに自分の手で理想の温泉を開湯したいという夢を持っていた私ですが、その目標の5%くらいを達成することができたかなと満足しています。このエントリーは、カ

    エンジニアだけど米国で足湯を開湯した話