アカウント名:
パスワード:
きちんとドキュメントをまとめることができるプログラマのコードには、そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
コードとドキュメントを読んでいって、どちらも読みやすい人と、どちらも読みにくい人のどちらかしか巡り合ったことのない私は不運でしょうか?
後者に限って、「ドキュメントなんて…」と言うわ、口頭説明も嫌がるわ、だったり。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
身近な人の偉大さは半減する -- あるアレゲ人
憶測でコメントしますが (スコア:0)
きちんとドキュメントをまとめることができるプログラマのコードには、
そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
Re: (スコア:1)
・外部仕様やデザインポリシーはメモ程度で良いのでドキュメント化しとくべき、後になると自分でも何でこんなことをやったのか目的が理解できなくなることがある。
・プログラムの内部仕様をドキュメント化するのは時間の無駄、そんなものを書く時間があるのならば綺麗な読みやすいコードを書くのに時間をかけた方が何倍もまし。
・読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。
Re:憶測でコメントしますが (スコア:1)
コードとドキュメントを読んでいって、どちらも読みやすい人と、
どちらも読みにくい人のどちらかしか巡り合ったことのない私は不運でしょうか?
後者に限って、「ドキュメントなんて…」と言うわ、口頭説明も嫌がるわ、だったり。