I played with that at one point.  Guido suggested it was a bad idea.
If you redirect stuff into a second file then you have way more points
of failure--the files could get out sync, for example.  I tend to agree.

We could, however, change Clinic so it generated most of the junk at the bottom of the file, where you don't need to look at it.

Or we could copy a page out of the PyPy playbook: generate a mandlebrot
as a comment at column 0, then put the real text at column 80+.  In the
right editor you'd never see it again!

In any case let's leave it for now.  We can revisit it later once we've
had a little more experience living with Clinic.