アカウント名:
パスワード:
コラム主の言うとおり、素人が書いた劣悪なドキュメントなんて「作る・管理する・見る」とあらゆる場面で無駄しか産まない。良質なドキュメントを作るにも手間がかかるのだから、その価値が手間を下回るなら作らないという選択もありえるでしょう。
ほんとコレ。百害あって一利無しなドキュメントしか書けないほどドキュメント作成の技術が不足しているなら、ドキュメントなぞ作らないほうが良い。
ドキュメントを利用してそれを活かせる環境であるならばドキュメントに意義もあるが、その場合別に自動生成用メタデータ・コメントの形でソースコードに埋め込んであっても何の問題もない。タレこみ人の作るコメント・メタデータがどのくらい有用だったのかはわからないけれど、存在すると逆に有害なドキュメントが存在するという事実は覆しようがない。
技術が不足しているって言ってるのに技術が足りている場合の話してる奴が多すぎる。この場合、ドキュメント利用をやめるか、ドキュメント利用技術を高めるか、道は二つ。有害なドキュメントを無為に垂れ流したところで品質も技術も向上などするわけがない。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
人生unstable -- あるハッカー
ドキュメントの質も重要だよね。 (スコア:1)
コラム主の言うとおり、素人が書いた劣悪なドキュメントなんて「作る・管理する・見る」とあらゆる場面で無駄しか産まない。
良質なドキュメントを作るにも手間がかかるのだから、その価値が手間を下回るなら作らないという選択もありえるでしょう。
Re: (スコア:0)
ほんとコレ。
百害あって一利無しなドキュメントしか書けないほどドキュメント作成の技術が不足しているなら、ドキュメントなぞ作らないほうが良い。
ドキュメントを利用してそれを活かせる環境であるならばドキュメントに意義もあるが、その場合別に自動生成用メタデータ・コメントの形でソースコードに埋め込んであっても何の問題もない。
タレこみ人の作るコメント・メタデータがどのくらい有用だったのかはわからないけれど、存在すると逆に有害なドキュメントが存在するという事実は覆しようがない。
技術が不足しているって言ってるのに技術が足りている場合の話してる奴が多すぎる。
この場合、ドキュメント利用をやめるか、ドキュメント利用技術を高めるか、道は二つ。
有害なドキュメントを無為に垂れ流したところで品質も技術も向上などするわけがない。