The examples you add to document your project are like a map to the buried treasure that is your library/API/tool/etc. But if the examples are wrong, it’s like labeling the map with “promised land” right over the spot where it should say, “there be dragons”.
It’s less about testing your code with your documentation, than the other way around. Make sure that the examples in your documenation stay current with your code. coffeedoctest is a way to test your documentation with your code… to make sure that the map matches the terrain.
If you’ve spent any time working in Python, then you are probably familiar with doctest. Coffeedoctest is built along the same lines.
For entire story visit the coffeedoctest project page on github.