[dools]

I think that's really cool! Next step: parse those stories using a BDD framework! Looking at that interface brings to mind something like lettuce.it

You could parse out the comments into a separate story block then write in the features/notes from lettuce and have them link back to each chunk of the code - providing coverage reports and the like.

Now it just needs a vim plugin ;)

[JonnieCache]

Whoever eventually figures out the obvious-yet-hidden confluence between cucumber-style BDD 'stories' and javadoc-style documentation is going to make a big splash in the word of programming. I can only hope it's me :)

[JoachimSchipper]

Did you see doctest? (http://docs.python.org/library/doctest.html)

[shahriarhaque]

I think this could be another brilliant addition to the "documentation view". Imagine a multi-tabbed documentation pane. The first tab lets you write normal comments, but in another one you could write doctests like the example you gave, or even assertion of pre and post conditions.

[shasta]

   Scenario:
   First I had a problem
   Then I thought, "I know, I'll use BDD"
   Then I had two problems