最近齢10年強の古のコード読みふけってるけど、ドキュメントに why, why not を書かない人は本当に多い。そしてクッソ古いドキュメントが放置されてたり、すでに通らないコードブロックが残ってたり。

shag のブックマーク 2022/06/19 15:39

<blockquote class="hatena-bookmark-comment"><a class="comment-info" href="https://b.hatena.ne.jp/entry/4721154240209523202/comment/shag" data-user-id="shag" data-entry-url="https://b.hatena.ne.jp/entry/s/gfngfn.github.io/ja/posts/2022-06-18-be-a-documentation-geek/" data-original-href="https://gfngfn.github.io/ja/posts/2022-06-18-be-a-documentation-geek/" data-entry-favicon="https://cdn-ak2.favicon.st-hatena.com/64?url=https%3A%2F%2Fgfngfn.github.io%2Fja%2Fposts%2F2022-06-18-be-a-documentation-geek%2F" data-user-icon="/users/shag/profile.png">ドキュメントに固執せよ - gfnweb</a><br><p style="clear: left">最近齢10年強の古のコード読みふけってるけど、ドキュメントに why, why not を書かない人は本当に多い。そしてクッソ古いドキュメントが放置されてたり、すでに通らないコードブロックが残ってたり。</p><a class="datetime" href="https://b.hatena.ne.jp/shag/20220619#bookmark-4721154240209523202"><span class="datetime-body">2022/06/19 15:39</span></a></blockquote><script src="https://b.st-hatena.com/js/comment-widget.js" charset="utf-8" async></script>

このブックマークにはスターがありません。
最初のスターをつけてみよう！

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

gfngfn.github.io2022/06/18

どうして人間集団はこんなにも知見の共有を円滑にできないのか？改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい．ここでテーマにしているのは，著名OSSな...

1004 人がブックマーク・88 件のコメント

他のコメントを読む

＼コメントがサクサク読めるアプリです／

はてなブックマーク

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

はてなブックマーク

公式Twitter

はてなのサービス