アカウント名:
パスワード:
できあがったものの簡潔な説明は、確かにここで指摘されたように有用だと思う。けど、設計書にその役割を求めると、理想はともかくとして大概「格言」に引っ掛かることになるよね。
出来上がったもののを書くのは順番が逆です。ほぼ意味が無い。ドキュメントとして必要な部分を理解していれば、メンテナンスも困難ではありません。
問題になるとすれば ・必要以上のものを「必須記述項目」として管理しようとしている ・プロジェクト面メンバーの怠惰(後の事、他人のことを考慮しないモラルの低さ)ぐらいしかなく、それは必ずクリアする必要があるものです。
# 個人や超少人数なら、ほとんどドキュメントは不要かも・・・
> ・必要以上のものを「必須記述項目」として管理しようとしている
改版履歴および改変個所の明示
orz
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
アレゲはアレゲ以上のなにものでもなさげ -- アレゲ研究家
前か後か (スコア:1)
できあがったものの簡潔な説明は、確かにここで指摘されたように有用だと思う。
けど、設計書にその役割を求めると、理想はともかくとして大概「格言」に引っ掛かることになるよね。
Re: (スコア:0)
出来上がったもののを書くのは順番が逆です。ほぼ意味が無い。
ドキュメントとして必要な部分を理解していれば、メンテナンスも困難ではありません。
問題になるとすれば
・必要以上のものを「必須記述項目」として管理しようとしている
・プロジェクト面メンバーの怠惰(後の事、他人のことを考慮しないモラルの低さ)
ぐらいしかなく、それは必ずクリアする必要があるものです。
# 個人や超少人数なら、ほとんどドキュメントは不要かも・・・
Re:前か後か (スコア:0)
> ・必要以上のものを「必須記述項目」として管理しようとしている
改版履歴および改変個所の明示
orz