ドキュメントとテストを一体にしてほしい。仕様＝テストでいいんじゃないだろうか。
だから、ドキュメント内のコードをテストとして実行できる仕組みを作ればいい
（たしかpythonにはある）