Docco (and its variants) do sort of what you describe:
http://jashkenas.github.com/docco/
I can see its usefulness in documenting test cases.
Re:Readme Driven Development
by benbjohnson on Tuesday August 31, 2010 @02:10PM
(#1650298)
That's awesome how it shows the comments and code side-by-side. The only downside is that I have to describe the functionality while I'm writing code instead of beforehand. Thanks, adorton.
The README shouldn't hold every detail of your implementation but it would be a good starting point for developers trying to find where described functionality is located in a library.
Also, it would provide the inverse: You can see what test cases you have that are not described in your documentation.