I wonder if you could make an editor that that looks like docco when you're writing the code?
Looking at the example... how is this better than just going and reading the source?
I should probably point out that selfDoc returns an object that can be moved about as JSON, but combined with a templating engine you can produce HTML docs that always stay in sync with the code. https://github.com/rudenoise/selfDoc.js/tree/master/demo