アカウント名:
パスワード:
ソース自体が設計書(の一部)なんですが。大体、他の物作りでも、自然言語だけでは正確な指示は出来ないので、その仲介として図面などが存在して、それらはとてもじゃないけど、シロート(あえてカタカナ)には書くことどころか、読み取ることも出来ない。(ソースよりは判ったふりはしやすい)
要するに、「セッケーショがぁ」と騒ぐ上司は、他の物作りの場面で図面とか判ったふりをする奴。ポンチ絵でも描いてわたしゃ納得しますって。
社内SEなんで自分も設計書なんて作ったことなかったんですが、こないだ初めてお客さんに納品するツールを作んないといけなくなって、その「納品」のために設計書を書かされました。納品物としての設計書を。
ほんと、ソース見ろって言いたかったです。でも見せたところでお客さんが理解できるわけないし、社内で共有する人だっていないし、作る前から作る意味がないことがわかってたのに結局その更新とかに時間がとられて非常に腹立たしかったですね……。
そういう単なるエビデンスとしての設計書を求められるような場合は、Doxygen とかの自動化ツールでババーッと作っちゃうのがいいですね。
だいたいある程度のボリュームの文書が存在することが重要であって、中身なんて結局まともに読まれないことの方が多いし。
それが外と仕事するって事でしょ。社内で適当に便利ツール作ってるのとは違うんだから立場を認識しないと。そもそも社内SEだったとしてもあなたが退職した後の人間にいちいちソースを追って動きを理解していけと?まあcsvファイルを読み込んで一括処理しますみたいなExcelのVBAだけやってますとかならそれでもいいけどさ。
半年後)納品先の社長「今日から一緒に働くことになったA君だ。前職は○○ソフトで働いていたベテランSEで社内システムを管理してもらう」 「A君、早速だが半年前に納品されたツールを見ておいてくれ。」・・・A「社長、何ですかツール。コードを見ましたが無駄だらけだしnullになるケースがありそうですよ。設計書も納品されてないようですし 電話で問い合わせたのですが当事の担当はもう辞めてしまったそうです。」
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
人生の大半の問題はスルー力で解決する -- スルー力研究専門家
ソース自体 (スコア:2)
ソース自体が設計書(の一部)なんですが。
大体、他の物作りでも、自然言語だけでは正確な指示は出来ないので、その仲介として図面などが存在して、それらはとてもじゃないけど、シロート(あえてカタカナ)には書くことどころか、読み取ることも出来ない。(ソースよりは判ったふりはしやすい)
要するに、「セッケーショがぁ」と騒ぐ上司は、他の物作りの場面で図面とか判ったふりをする奴。ポンチ絵でも描いてわたしゃ納得しますって。
Re:ソース自体 (スコア:0)
社内SEなんで自分も設計書なんて作ったことなかったんですが、こないだ初めてお客さんに納品するツールを作んないといけなくなって、その「納品」のために設計書を書かされました。納品物としての設計書を。
ほんと、ソース見ろって言いたかったです。でも見せたところでお客さんが理解できるわけないし、社内で共有する人だっていないし、作る前から作る意味がないことがわかってたのに結局その更新とかに時間がとられて非常に腹立たしかったですね……。
Re:ソース自体 (スコア:2)
そういう単なるエビデンスとしての設計書を求められるような場合は、
Doxygen とかの自動化ツールでババーッと作っちゃうのがいいですね。
だいたいある程度のボリュームの文書が存在することが重要であって、
中身なんて結局まともに読まれないことの方が多いし。
Re: (スコア:0)
それが外と仕事するって事でしょ。
社内で適当に便利ツール作ってるのとは違うんだから立場を認識しないと。
そもそも社内SEだったとしてもあなたが退職した後の人間にいちいちソースを追って動きを理解していけと?
まあcsvファイルを読み込んで一括処理しますみたいなExcelのVBAだけやってますとかならそれでもいいけどさ。
Re: (スコア:0)
半年後)
納品先の社長「今日から一緒に働くことになったA君だ。前職は○○ソフトで働いていたベテランSEで社内システムを管理してもらう」
「A君、早速だが半年前に納品されたツールを見ておいてくれ。」
・・・
A「社長、何ですかツール。コードを見ましたが無駄だらけだしnullになるケースがありそうですよ。設計書も納品されてないようですし
電話で問い合わせたのですが当事の担当はもう辞めてしまったそうです。」