[Doc-SIG] Re: docstring signatures

[Guido van Rossum]

> From direct personal experience (15 or so Perl modules, some on CPAN and
> some not, comprising ~10k LoC), I *do* think that intermingling code and
> documentation makes it easier to update them together.
> 
> Note that it does not make it *absolutely* easy or painless or automatic;
> any of those are bogus arguments.  But having code and doccs in the same
> file definitely makes life *less* painful.

What argues against this for me is the existence of highly tuned
language-specific editing modes in Emacs and many other text editors;
these rarely do a good job on hybrids.

--Guido van Rossum (home page: http://www.python.org/~guido/)