アカウント名:
パスワード:
コードに一対一対応するようなドキュメントに限定すれば
書き上げたソースコード(そのテストコードも含む)に書かれている内容が、仕様書と同等に他人が読めれば「同じ事を二つ書くのは無駄でしょ?」と言えるでしょ。あなたには、それができてないから「コードに解説書つけろ、他人には理解できない成果物だ、それは」言われているのですよ。
# 個人的には、すべてのドキュメントはソースコード(コメント含む)に記述すべし、他にはいらない、と思ってる
取っ掛かりとしての、 readme.txt の追加も希望。
#スタート(main関数等)がどのソースなのかもわからないプロジェクトがある
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
ソースを見ろ -- ある4桁UID
管理者がドキュメントを書くように言わないようにするには? (スコア:1)
Re:管理者がドキュメントを書くように言わないようにするには? (スコア:0)
コードに一対一対応するようなドキュメントに限定すれば
書き上げたソースコード(そのテストコードも含む)に書かれている内容が、仕様書と同等に他人が読めれば「同じ事を二つ書くのは無駄でしょ?」と言えるでしょ。
あなたには、それができてないから「コードに解説書つけろ、他人には理解できない成果物だ、それは」言われているのですよ。
# 個人的には、すべてのドキュメントはソースコード(コメント含む)に記述すべし、他にはいらない、と思ってる
Re: (スコア:0)
取っ掛かりとしての、
readme.txt の追加も希望。
#スタート(main関数等)がどのソースなのかもわからないプロジェクトがある