SUO: Documentation and Implementation

["John F. Sowa" <sowa@bestweb.net>]

I have been out of town for a few days,
so it will take me a while to catch up
with the mass of email.

But I wanted to post the slides to a talk
that I gave, which addresses some of the
issues that have been discussed recently:

   http://www.jfsowa.com/talks/bergen.htm

Following is the first slide, which
summarizes the general approach.

John Sowa
______________________________________________

          Documentation and Implementation

They will never be consistent unless...

    Both are automatically derived from a common source. 

For legacy code,

    Some documentation can be derived from the implementation. 

For new code in current languages,

    Some of the implementation can be derived from the documentation. 

With well-designed tools and languages,

    Documentation can be identical to implementation.