Path: utzoo!utgpu!news-server.csri.toronto.edu!rpi!zaphod.mps.ohio-state.edu!mips!apple!netcomsv!jls
From: jls@netcom.COM (Jim Showalter)
Newsgroups: comp.software-eng
Subject: Re: Modifiability
Message-ID: <1991Jun7.073448.11818@netcom.COM>
Date: 7 Jun 91 07:34:48 GMT
References: <2192@Terra.cc.brunel.ac.uk> <1991Jun07.020546.29682@xstor.com>
Distribution: comp.software-eng
Organization: Netcom - Online Communication Services  UNIX System {408 241-9760 guest}
Lines: 13

>The main use of a design document is to communicate your design to others.
>If you are hard to understand, your design will be hard to understand and it
>will be hard for others to modify.

Einstein was fond of saying that if you can't explain to an 8 year
old what you are doing, you obviously don't know. Using this metric,
I've seen precious few design documents written by people who know
what they're building.
-- 
**************** JIM SHOWALTER, jls@netcom.com, (408) 243-0630 ****************
*Proven solutions to software problems. Consulting and training on all aspects*
*of software development. Management/process/methodology. Architecture/design/*
*reuse. Quality/productivity. Risk reduction. EFFECTIVE OO usage. Ada/C++.    *