* I see the point of referring to its origin. And I know docstrings and doctests from Python. But mentioning docstrings without further explanation and the fact that there are no docstrings in Javascript may be really confusing for people new to doctests. Maybe we can find a better text: "Doctest finds usage examples in documenting code comments. It verifies your documentation and your code by executing those examples. This project verifies JavaScript and CoffeeScript modules."
* As included in my new proposed text I totally agree with the aspect of testing documentation. But I wouldn't say that it is the main task. For it is both together in equal parts. Testing documentation _and_ code at the same time. It encourages to document with more examples and to test more of your code.