ドキュメントって言った時に、サービス仕様を説明するものと、実装を説明したものがあると思うけど、前者は絶対必要、後者は必要悪みたいな存在。実装の説明を自然言語でする必要があるのかは疑問

lifeisadog のブックマーク 2018/09/19 13:23

<blockquote class="hatena-bookmark-comment"><a class="comment-info" href="https://b.hatena.ne.jp/entry/351625774/comment/lifeisadog" data-user-id="lifeisadog" data-entry-url="https://b.hatena.ne.jp/entry/s/medium.com/@laqiiz/%E6%88%91%E3%80%85%E3%81%AF%E3%81%84%E3%81%8B%E3%81%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E9%96%8B%E7%99%BA%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E8%85%90%E3%82%8B%E5%95%8F%E9%A1%8C%E3%81%A8%E6%88%A6%E3%81%88%E3%81%B0%E8%89%AF%E3%81%84%E3%81%AE%E3%81%8B-7c7c3774689f" data-original-href="https://medium.com/@laqiiz/%E6%88%91%E3%80%85%E3%81%AF%E3%81%84%E3%81%8B%E3%81%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E9%96%8B%E7%99%BA%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E8%85%90%E3%82%8B%E5%95%8F%E9%A1%8C%E3%81%A8%E6%88%A6%E3%81%88%E3%81%B0%E8%89%AF%E3%81%84%E3%81%AE%E3%81%8B-7c7c3774689f" data-entry-favicon="https://cdn-ak2.favicon.st-hatena.com/64?url=https%3A%2F%2Fmedium.com%2F%40laqiiz%2F%25E6%2588%2591%25E3%2580%2585%25E3%2581%25AF%25E3%2581%2584%25E3%2581%258B%25E3%2581%25AB%25E3%2582%25B7%25E3%2582%25B9%25E3%2583%2586%25E3%2583%25A0%25E9%2596%258B%25E7%2599%25BA%25E3%2581%25AB%25E3%2581%258A%25E3%2581%2591%25E3%2582%258B%25E3%2583%2589%25E3%2582%25AD%25E3%2583%25A5%25E3%2583%25A1%25E3%2583%25B3%25E3%2583%2588%25E8%2585%2590%25E3%2582%258B%25E5%2595%258F%25E9%25A1%258C%25E3%2581%25A8%25E6%2588%25A6%25E3%2581%2588%25E3%2581%25B0%25E8%2589%25AF%25E3%2581%2584%25E3%2581%25AE%25E3%2581%258B-7c7c3774689f" data-user-icon="/users/lifeisadog/profile.png">我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか</a><br><p style="clear: left">ドキュメントって言った時に、サービス仕様を説明するものと、実装を説明したものがあると思うけど、前者は絶対必要、後者は必要悪みたいな存在。実装の説明を自然言語でする必要があるのかは疑問</p><a class="datetime" href="https://b.hatena.ne.jp/lifeisadog/20180919#bookmark-351625774"><span class="datetime-body">2018/09/19 13:23</span></a></blockquote><script src="https://b.st-hatena.com/js/comment-widget.js" charset="utf-8" async></script>

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

我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか

medium.com/@laqiiz2017/12/11

フューチャーアーキテクト Advent Calendar 2017 の2日目です。システム設計が大好きで大嫌いな皆さん、こんにちは。突然ですが、皆さんはどのようにシステム設計におけるドキュメント腐る問題に立ち向かって...

99 人がブックマーク・7 件のコメント

他のコメントを読む

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

はてなブックマーク

我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか

はてなブックマーク

公式Twitter

はてなのサービス