アカウント名:
パスワード:
確かにドキュメントは大事ですね。分かっている人が、分かっている人向けに書いたドキュメントとか見るとうんざりすることも多いです。分かっている人しか見ないなら別にいいんですけど・・・。
ふむ、分かっている人が、分かっている人向けに書いたドキュメントは非常に分かり易いけどね。分かってない人が、分かってない人向けに書いたドキュメントは意味不明。
対象物に関して良く分かっていて、分からない人がどのぐらい分からないかも分かっている人が丁寧に書いたドキュメント → くどいけどほとんどの人に分かりやすい
対象物に関してよく分かっている人が、よく分かっている人向けに書いたドキュメント → よく分かっている人には最適。よく分かっていない人には理解できない。
対象物に関してよく分かっていない人が書いたドキュメント → ゴミ。場合によっては変な誤解を誘発するんで無いよりも悪い結果をもたらす。
2番目はよく分かってる人(勉強してる人)には「最適」なんだから、よく分かってない人(勉強してない人)がそれに文句を言うのはお門違い。勉強しないで1番目を要求する人に限って本人が書くのは3番だったりする。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
人生unstable -- あるハッカー
複雑化 (スコア:2)
確かにドキュメントは大事ですね。
分かっている人が、分かっている人向けに書いたドキュメントとか見るとうんざりすることも多いです。
分かっている人しか見ないなら別にいいんですけど・・・。
Re:複雑化 (スコア:1)
ふむ、分かっている人が、分かっている人向けに書いたドキュメントは非常に分かり易いけどね。
分かってない人が、分かってない人向けに書いたドキュメントは意味不明。
Re: (スコア:0)
対象物に関して良く分かっていて、分からない人がどのぐらい分からないかも分かっている人が丁寧に書いたドキュメント → くどいけどほとんどの人に分かりやすい
対象物に関してよく分かっている人が、よく分かっている人向けに書いたドキュメント → よく分かっている人には最適。よく分かっていない人には理解できない。
対象物に関してよく分かっていない人が書いたドキュメント → ゴミ。場合によっては変な誤解を誘発するんで無いよりも悪い結果をもたらす。
Re: (スコア:0)
2番目はよく分かってる人(勉強してる人)には「最適」なんだから、
よく分かってない人(勉強してない人)がそれに文句を言うのはお門違い。
勉強しないで1番目を要求する人に限って本人が書くのは3番だったりする。