for years, i've been secretly wishing that doctests would take off because it seems to really solve two problems at once:
- it puts a simple usage example into the documentation - you get an easy-to-write, quick-to-run little assertion test that ensures basic functionality is saved