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=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Thread: 103376,2a687662f09731bb X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news2.google.com!newsfeed.gamma.ru!Gamma.RU!npeer.de.kpn-eurorings.net!newsfeed2.scan-plus.net!news.germany.com!feeder2.news.jippii.net!feeder1.news.jippii.net!nntp.inet.fi!central1.inet.fi!inet.fi!read3.inet.fi.POSTED!53ab2750!not-for-mail Sender: AWI003@FIW9430 Newsgroups: comp.lang.ada Subject: Re: Request for comments on simple Ada program References: <87psp1lsc4.fsf@willow.rfc1149.net> <87hdadlgrl.fsf@willow.rfc1149.net> From: Anders Wirzenius Message-ID: User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Wed, 16 Nov 2005 09:10:44 GMT NNTP-Posting-Host: 194.251.142.2 X-Complaints-To: abuse@inet.fi X-Trace: read3.inet.fi 1132132244 194.251.142.2 (Wed, 16 Nov 2005 11:10:44 EET) NNTP-Posting-Date: Wed, 16 Nov 2005 11:10:44 EET Organization: Sonera corp Internet services Xref: g2news1.google.com comp.lang.ada:6421 Date: 2005-11-16T09:10:44+00:00 List-Id: Samuel Tardieu writes: > What I do in general is reread every code I write one week later. Each > time I ask myself "why did I do this?", even for one second, I add a > comment. My experience shows that even when I go through the code one > year later, I have no question that are not already answered in the > comments. > Excellent way of working! Once upon a time (early eighties) when I was a Fortran programmer, my colleague and I used to start coding by writing a pseudo code. The syntax for the pseudo code was Ada. Much of the Ada code was left in the Fortran code as comments. -- Anders