#expertpython エキスパートPythonプログラミング読書会13
- shimizukawa
- 2182
- 0
- 0
- 0
Sphinx の autodoc を使うと docstring をドキュメントに反映しやすいので、doctest をやる気が上がるらしい。意図と実装が一緒になっているので、変更漏れが少なくなる。これもひとつの TDD。 #expertpython
2011-06-21 20:30:47日本語訳これ? http://www008.upp.so-net.ne.jp/minami/quickref.html #expertpython
2011-06-21 20:33:26reStructuredTextのクイックリファレンス http://t.co/Ivzgfri #expertpython
2011-06-21 20:35:02Sphinx の便利メモ。 / 逆引き辞典 - http://t.co/nRuJInz #expertpython
2011-06-21 20:36:09RT @togakushi: 「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython
2011-06-21 20:41:05RT @togakushi: 「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython
2011-06-21 20:41:20ドキュメントの「ポートフォリオ」を作りましょう。再利用可能なテンプレートのことで、目的別に保管しておく。完成したドキュメントから作り直すと良さそう。先にポートフォリオを作り始めたら死亡フラグ。 #expertpython
2011-06-21 20:45:22RT @togakushi: 「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython
2011-06-21 20:47:06RT @togakushi: 「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython
2011-06-21 20:50:26前プロジェクトのドキュメントをコピーして使う派多数。コピー元のバージョン古かったら終わるよね。特にエクセル方眼紙。 #expertpython
2011-06-21 20:51:35docutilsは単独のreSTファイルをHTMLなどに変換できる。一方、Sphinxは複数のreSTファイルから構造化されたHTMLを生成できる。 #expertpython
2011-06-21 20:51:48Q「ドキュメントポートフォリオ的なものを持っていますか?」 A 「前のドキュメントからコピペはよくやってる」「WordやExcelで踏襲元を間違えると大変..」 #expertpython
2011-06-21 20:52:18