From: "trans.  (T. Onoma)" <transami@...>
Date: 2004-10-15T23:59:23+09:00
Subject: Re: documentation as source

On Friday 15 October 2004 06:59 am, gabriele renzi wrote:
| this is interesting, but still requires a lot of typing from you.
| I'd prefer florian gross' approach to extract data from embedded
| comments. No performance hit, real samples, no extraneous code.
| Ok we'd have to admit that python got his doctest module before us but,
| hey not too bad :)

I have three issues with using comments in this way.

  1. Comments take on meaning. Comments with syntax errors? Ick.
  2. Tests can be HUGE. Explanation comments already take up enough space.
  3. SOC is important too.

T.