[python] ドキュメント作成に関して調べる

ドキュメントなんて作ったこと無い。今後も作る気は無かった。
でも、そうも言っていられなくなってきた。。
自分以外の誰かが使うものならば、ドキュメントは作成するべき。

でも、大抵のプログラマはドキュメント作成は苦手なんだろうと思われる。
ruby開発者のまつもと氏ですらも、こう言っている。

ドキュメント
まつもとの苦手なもの。彼は普段から「ソースがドキュメントだ。バグも完全に記述されている」と主張しているが、誰も受け入れない。 当り前だ。

名言過ぎる。。。

続きを読む [python] ドキュメント作成に関して調べる