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

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

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

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

名言過ぎる。。。

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

[python] モジュールの作り方に関して考えた

今までPythonでMaya用のスクリプトを書く際には、でっかいクラスを作成してその中にいろいろ書いてました。
だけどそういう使い方だとモジュールとクラスの役割が同じようになっている感じに見えて、どうしても二度手間な感じだなぁと思っていました。
そういうことを考えつつ、昨日pythonを1個書いてみました。
続きを読む [python] モジュールの作り方に関して考えた