アカウント名:
パスワード:
微細に書かせるから書きたくなくなるんだよ。
# ドキュメント?欲しけりゃくれてやる# 俺の全てをソースに置いてきた
実装詳細をいちいち微細に書かせてたんならそう言いたくなるのは当然だよね。もし詳細な仕様を書かされたと文句言ってるのなら首切って排除するのが上司の仕事だけど。
# 俺の全てをソースに置いてきたと言ってる所を見る限り怪しいけどこれだけでは判断できないな。
実装詳細を仕様書に書け仕様書に書けと上(主に一時請け)が口をすっぱくして言うので、最終的にソースをWordにコピペして変数名などを日本語に直した、という事態を何度も体験したことがあります。
詳細に書けはそういう事態を招くので、適切な粒度を指定しないと危ないです。 つーか、本当に詳細な設計書は製造レベルで考えないといけないので、それだったら製造したほうが早い→ソースを設計書にコピペ、という空気になりがち。 (特にスケジュールが押してて、仕様書が納品物だと。) そしてそんな設計書であれば、始めからソースを読んだ方が早いので誰も読みませんでした。
設計書の大切さは何度も実感させられていますが、ちゃんと用途/目的と粒度を意識しないと、読む方にも作成者にも意味が無いものになってしまいます。 この記事で言っている設計書がどの程度のものかは判りませんが、そこを踏まえないとたぶん落とし穴にはまる気がします。
# 個人的には、ちゃんとした文章は仕様のポイントやらをまとめた基本設計だけで、後はクラス図や要点のシーケンス図なりとJavadocぐらいが気楽です。もちろんシステムの規模にもよりますが。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
普通のやつらの下を行け -- バッドノウハウ専門家
簡潔に説明する文章だけならいいんだよ (スコア:1)
微細に書かせるから書きたくなくなるんだよ。
# ドキュメント?欲しけりゃくれてやる
# 俺の全てをソースに置いてきた
Re: (スコア:0)
実装詳細をいちいち微細に書かせてたんならそう言いたくなるのは当然だよね。
もし詳細な仕様を書かされたと文句言ってるのなら首切って排除するのが上司の仕事だけど。
# 俺の全てをソースに置いてきた
と言ってる所を見る限り怪しいけどこれだけでは判断できないな。
Re:簡潔に説明する文章だけならいいんだよ (スコア:0)
実装詳細を仕様書に書け仕様書に書けと上(主に一時請け)が口をすっぱくして言うので、最終的にソースをWordにコピペして変数名などを日本語に直した、という事態を何度も体験したことがあります。
詳細に書けはそういう事態を招くので、適切な粒度を指定しないと危ないです。
つーか、本当に詳細な設計書は製造レベルで考えないといけないので、それだったら製造したほうが早い→ソースを設計書にコピペ、という空気になりがち。
(特にスケジュールが押してて、仕様書が納品物だと。)
そしてそんな設計書であれば、始めからソースを読んだ方が早いので誰も読みませんでした。
設計書の大切さは何度も実感させられていますが、ちゃんと用途/目的と粒度を意識しないと、読む方にも作成者にも意味が無いものになってしまいます。
この記事で言っている設計書がどの程度のものかは判りませんが、そこを踏まえないとたぶん落とし穴にはまる気がします。
# 個人的には、ちゃんとした文章は仕様のポイントやらをまとめた基本設計だけで、後はクラス図や要点のシーケンス図なりとJavadocぐらいが気楽です。もちろんシステムの規模にもよりますが。