Path: utzoo!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!usc!samsung!emory!mephisto!mcnc!rti!ntpdvp1!willr
From: willr@ntpdvp1.UUCP (Will Raymond)
Newsgroups: comp.arch
Subject: Re: It looks like he's at it again!
Summary: Modularity,Extensibility,Comments = MAINTAINABILITY
Message-ID: <604@ntpdvp1.UUCP>
Date: 16 Jul 90 19:59:36 GMT
References: <1990Jul12.012730.4248@Stardent.COM> <64044@sgi.sgi.com>
Organization: Northern Telecom DMS-10 Div., Raleigh, NC
Lines: 22


 Portability, modularity, programming style, and extensibility are
 religious issues.

	While I agree with some of what Karsh says about CS education there
	is one good reason these issues are emphasized, maintainability.
	Too often, I've had to wade through spaghetti code written by a
	'supposed' hot-shot programmer who didn't feel the need for 
	comments, modularity, portability, etc. to find/correct a problem or
	extend the use of the code.  I consider it common courtesy for those 
    follow to follow a minimal set of common sense rules...major of
	which is documentation ( I don't mean reams of doc. just indicative doc.
	at the function level...with the understanding that the module is
	readable and fits in no less than 2 pgs. { my personal thumb rule -
	if I can't get it on two screens it's probabally too long } ).

    *******       Will Raymond - Northern Telecom NTP in RTP
|  | ~   ~ |  |
   . O   o .      I speak for myself.
|     .V.     |   
     ._ _.     	  "A day without sunshine is a day at work."	   
|      U      |