News for hackers. Stuff that matters.
Re:Readme Driven Development by adorton on Monday August 23, 2010 @07:25PM (#1628392)
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.