> Put tests in comments so that they are easier to ignore no, they indeed belong elsewhere - at the end of the file or in different files altogether, potentially to be pulled in by documentation tool - not as distractions to the actual implementation.
there exists another way to separate the two: by using forward declarations and placing all documentation and other cruft there while implementation lives separately. not sure this is an improvement though, lots of repetition of proc headers.
