From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: *** X-Spam-Status: No, score=3.8 required=5.0 tests=BAYES_00,INVALID_MSGID, RATWARE_MS_HASH,RATWARE_OUTLOOK_NONAME autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,2afac1a4161c7f35 X-Google-Attributes: gid103376,public From: "Nick Roberts" Subject: Re: Distinguishing type names from other identifiers Date: 1998/01/15 Message-ID: <01bd2207$18f3fac0$95fc82c1@xhv46.dial.pipex.com>#1/1 X-Deja-AN: 316345841 Content-Transfer-Encoding: 7bit References: <884736089.2104295427@dejanews.com> <69lael$90o@top.mitre.org> Content-Type: text/plain; charset=ISO-8859-1 Organization: UUNet UK server (post doesn't reflect views of UUNet UK) Mime-Version: 1.0 Newsgroups: comp.lang.ada Date: 1998-01-15T00:00:00+00:00 List-Id: So the answer is ... interleave jokes in comments with your code! Programmers will love maintaining the code; and they'll have fun thinking up more jokes to put in. Interesting concept. Something like for T in Fuel_Tank_Count'Range loop -- Did you hear the one about the Scotsman, the Englishman, and the Irishman? Initialize_Fuel_Tank_Sensor(T); end loop; -- Well, there was a Scotsman, an Englishman, and an Irishman, -- and they were walking along a Dublin street one night, ... and so on. -- Nick Roberts Croydon, UK Proprietor, ThoughtWing Software; Independent Software Development Consultant * Nick.Roberts@dial.pipex.com * Voicemail & Fax +44 181-405 1124 * *** Eats three shredded spams every morning for breakfast *** Michael F Brenner wrote in article <69lael$90o@top.mitre.org>... > > No, the main objection to hour_type is not redundant information, > but ugliness. The secondary objection is the lack of plurals, so > that it does not read like an English sentence. The redundancy, if > it were redundant instead of vacuous, would not be so very objectionable. > > However, when stuff like _TYPE is added at the end of each type by > FIAT of a quality standard, you not only have changed the meaning > of quality from something that works well and is easily fixed to > something that is regimented, but you also have lost the reliability, > lost the maintainability, and lost the desire to read that code. > It is no longer cool code. > > Nothing affects maintainability more than a lack of desire to maintain it. >