アカウント名:
パスワード:
プログラムはドキュメントに書くべき内容を機械に理解できるように書いている(書こうとしている)に過ぎない
自分は、まずプログラムのコメント欄で機能説明や使い方を書いてから、それをコードに直す方法で作るから、二度同じ事を書いてるけど説明しやすいプログラムになるというメリットがある。先にプログラム作ってからだと、説明しにくいモノになる可能性がある。「二度同じ事」という点は同じでも順序によって大違い。
コードとドキュメントを二人で同時に書く事を指して、ペアプログラミングと呼んだら怒られるだろうか?
文芸的プログラミングをご所望?
単に仕様書・設計書を書く人と、コーディングする人は別であるべきだよねって話でしょ。
このタレコミ自体に疑問を感じるけど、「記述されたコードに対してドキュメントが書かれるべき」ではなくて「ドキュメントがあって、その仕様どおりにコードが記述されるべき」って話がなぜ起こらないの?
ウォーターフォールモデルだけに限定していないからでは?
それにしてもこの話題は10年前にも見ましたね。
コーディング自体だれがするかわからないときに、万人にわかるような仕様書を書くのが難しく、逆だとドキュメントを読む人が決まってるから、ましなのでは?
(ところで、コーディングってのどこまで内容が含まれるのかな?)
現実には、ドキュメントに書くべき内容とは違う内容がコードされたりするからドキュメントが必要になるような気もする。特にオプティマイズ等があると、仕様と互換のある別の表現を多用したりする事多し。
テスト(仕様書やxUnit)も考えると、同じ事について三種類の表現をしている事になるのか。# 三種類が本当に同じものに帰結するのが理想、という事でもあるのか・・・
一度実装した事があるなら移植は簡単でしょ?
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
吾輩はリファレンスである。名前はまだ無い -- perlの中の人
二度同じことを書かなきゃいけない (スコア:0)
プログラムはドキュメントに書くべき内容を機械に理解できるように書いている(書こうとしている)に過ぎない
Re:二度同じことを書かなきゃいけない (スコア:2)
自分は、まずプログラムのコメント欄で機能説明や使い方を書いてから、それをコードに直す方法で作るから、二度同じ事を書いてるけど説明しやすいプログラムになるというメリットがある。
先にプログラム作ってからだと、説明しにくいモノになる可能性がある。
「二度同じ事」という点は同じでも順序によって大違い。
the.ACount
Re: (スコア:0)
コードとドキュメントを二人で同時に書く事を指して、
ペアプログラミングと呼んだら怒られるだろうか?
Re: (スコア:0)
文芸的プログラミングをご所望?
Re: (スコア:0)
単に仕様書・設計書を書く人と、コーディングする人は別であるべきだよねって話でしょ。
このタレコミ自体に疑問を感じるけど、「記述されたコードに対してドキュメントが書かれるべき」ではなくて
「ドキュメントがあって、その仕様どおりにコードが記述されるべき」って話がなぜ起こらないの?
Re: (スコア:0)
ウォーターフォールモデルだけに限定していないからでは?
それにしてもこの話題は10年前にも見ましたね。
Re: (スコア:0)
コーディング自体だれがするかわからないときに、
万人にわかるような仕様書を書くのが難しく、
逆だとドキュメントを読む人が決まってるから、ましなのでは?
(ところで、コーディングってのどこまで内容が含まれるのかな?)
Re:二度同じことを書かなきゃいけない? (スコア:0)
現実には、ドキュメントに書くべき内容とは違う内容がコードされたりするからドキュメントが必要になるような気もする。
特にオプティマイズ等があると、仕様と互換のある別の表現を多用したりする事多し。
Re: (スコア:0)
テスト(仕様書やxUnit)も考えると、同じ事について三種類の表現をしている事になるのか。
# 三種類が本当に同じものに帰結するのが理想、という事でもあるのか・・・
Re: (スコア:0)
一度実装した事があるなら移植は簡単でしょ?