アカウント名:
パスワード:
ソース自体が設計書(の一部)なんですが。大体、他の物作りでも、自然言語だけでは正確な指示は出来ないので、その仲介として図面などが存在して、それらはとてもじゃないけど、シロート(あえてカタカナ)には書くことどころか、読み取ることも出来ない。(ソースよりは判ったふりはしやすい)
要するに、「セッケーショがぁ」と騒ぐ上司は、他の物作りの場面で図面とか判ったふりをする奴。ポンチ絵でも描いてわたしゃ納得しますって。
社内SEなんで自分も設計書なんて作ったことなかったんですが、こないだ初めてお客さんに納品するツールを作んないといけなくなって、その「納品」のために設計書を書かされました。納品物としての設計書を。
ほんと、ソース見ろって言いたかったです。でも見せたところでお客さんが理解できるわけないし、社内で共有する人だっていないし、作る前から作る意味がないことがわかってたのに結局その更新とかに時間がとられて非常に腹立たしかったですね……。
そういう単なるエビデンスとしての設計書を求められるような場合は、Doxygen とかの自動化ツールでババーッと作っちゃうのがいいですね。
だいたいある程度のボリュームの文書が存在することが重要であって、中身なんて結局まともに読まれないことの方が多いし。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
犯人は巨人ファンでA型で眼鏡をかけている -- あるハッカー
ソース自体 (スコア:2)
ソース自体が設計書(の一部)なんですが。
大体、他の物作りでも、自然言語だけでは正確な指示は出来ないので、その仲介として図面などが存在して、それらはとてもじゃないけど、シロート(あえてカタカナ)には書くことどころか、読み取ることも出来ない。(ソースよりは判ったふりはしやすい)
要するに、「セッケーショがぁ」と騒ぐ上司は、他の物作りの場面で図面とか判ったふりをする奴。ポンチ絵でも描いてわたしゃ納得しますって。
Re: (スコア:0)
社内SEなんで自分も設計書なんて作ったことなかったんですが、こないだ初めてお客さんに納品するツールを作んないといけなくなって、その「納品」のために設計書を書かされました。納品物としての設計書を。
ほんと、ソース見ろって言いたかったです。でも見せたところでお客さんが理解できるわけないし、社内で共有する人だっていないし、作る前から作る意味がないことがわかってたのに結局その更新とかに時間がとられて非常に腹立たしかったですね……。
Re:ソース自体 (スコア:2)
そういう単なるエビデンスとしての設計書を求められるような場合は、
Doxygen とかの自動化ツールでババーッと作っちゃうのがいいですね。
だいたいある程度のボリュームの文書が存在することが重要であって、
中身なんて結局まともに読まれないことの方が多いし。