2022年6月18日のブックマーク (2件)

  • ドキュメントに固執せよ - gfnweb

    どうして人間集団はこんなにも知見の共有を円滑にできないのか? 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい. ここでテーマにしているのは,著名OSSなど世の中にいくらでも知見が転がっている対象ではなく,特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである. 非常に乱暴な言い方をするなら,「コードとか大部分は誰でも書けるようになるものなんよ,そんなところにマッチョイズムとか感じなくてええねん,我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム(ソフトウェアなど)について,そのシステムのことを全く知らない人を想定読者としたドキュメント

    midnight-railgun
    midnight-railgun 2022/06/18
    腕時計の例で言うと、読者が置き時計を知っていないとこの情報のみから理解するのは困難だし、逆に知っているのであれば冗長だしで、やっぱりドキュメントって難しいなぁ
  • 働いてるのに生活保護と変わらない生活なのはおかしいって批判に

    なんで生活保護費を下げろって言うの?給料上げればいいじゃんって言う人たくさんいるが 意味不明なんだけど誰か説明出来る? 生活保護批判の主旨って、俺は働いてるけど生活保護と同じ収入なのは不公平だって話なんだよ 生活保護費を下げてでも自分に給付金でも出せ それじゃないと不公平 何かおかしいか? 当たり前だと思うけど しかも給料上げればいいって、給料上げろって言ったところで上がらないだろ お前らがじゃあ上げてみせろよって話 出来ないだろ なんで出来ないことを弱者に押し付けるんだよ アホかと お前ら当頭悪いよな

    働いてるのに生活保護と変わらない生活なのはおかしいって批判に
    midnight-railgun
    midnight-railgun 2022/06/18
    今日のブルース加速会場はここですか