[plt-scheme] Vision behind Scribble
For me, the biggest reason to put the documentation in the source code
is to reduce the chance of them getting out of sync. It's much easier
to update the documentation when it's right there next to the code
than if it's in some other file. But maybe this could be done better
with the right tools-- maybe a hyperlink next to the code that brings
you to the appropriate doc file to edit. Are there any systems
(e.g. Emacs packages) that work like this?
--dougorleans at gmail.com