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

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