On Thu, Nov 11, 2004 at 10:42:03AM -0800, Mike Orr wrote:
> >    Yes. The code is the only doc. For any project, not only for Quixote.
>
> That's fine if you never upgrade, but code is subject to incompatible
> changes.

   Documentation is almost always in incompatible state. Documentation
is almost always do not correspond to code, and often even contradict
the code. But of these two, you run the code, not the documentation.
Hence, the code is the only source of truth.

Oleg.
--
     Oleg Broytmann            http://phd.pp.ru/            phd@phd.pp.ru
           Programmers don't die, they just GOSUB without RETURN.