スナップショットと割り切るところはいいとしても、読んだ人が直すって手法に不安が残る。読んだ人が気づいた乖離のみ直されるわけで、結果どの時点のスナップショットとしても正しくなくなるように思う。

vndn のブックマーク 2021/08/16 15:44

<blockquote class="hatena-bookmark-comment"><a class="comment-info" href="https://b.hatena.ne.jp/entry/4706931406814230050/comment/vndn" data-user-id="vndn" data-entry-url="https://b.hatena.ne.jp/entry/s/blog.h13i32maru.jp/entry/2021/08/15/163619" data-original-href="https://blog.h13i32maru.jp/entry/2021/08/15/163619" data-entry-favicon="https://cdn-ak2.favicon.st-hatena.com/64?url=https%3A%2F%2Fblog.h13i32maru.jp%2Fentry%2F2021%2F08%2F15%2F163619" data-user-icon="/users/vndn/profile.png">ソフトウェアドキュメント作法 - maru source</a><br><p style="clear: left">スナップショットと割り切るところはいいとしても、読んだ人が直すって手法に不安が残る。読んだ人が気づいた乖離のみ直されるわけで、結果どの時点のスナップショットとしても正しくなくなるように思う。</p><a class="datetime" href="https://b.hatena.ne.jp/vndn/20210816#bookmark-4706931406814230050"><span class="datetime-body">2021/08/16 15:44</span></a></blockquote><script src="https://b.st-hatena.com/js/comment-widget.js" charset="utf-8" async></script>

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

ソフトウェアドキュメント作法 - maru source

blog.h13i32maru.jp2021/08/15

こんにちは丸山@h13i32maruです。つい先日、devchat.fmというポッドキャストに出演して、「ドキュメント」というお題について話しました。なぜこんなニッチなお題について話したかというと、Ubie Discoveryに入社...

577 人がブックマーク・30 件のコメント

他のコメントを読む

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

はてなブックマーク

ソフトウェアドキュメント作法 - maru source

はてなブックマーク

公式Twitter

はてなのサービス